Version 1.5

Semantic Personal Publishing Platform

First Things First

Welcome. WordPress is a very special project to me. Every developer and contributor adds something unique to the mix, and together we create something beautiful that I'm proud to be a part of. Thousands of hours have gone into WordPress, and we're dedicated to making it better every day. Thank you for making it part of your world.

— Matt Mullenweg

Installation: Famous 5-minute install

1. Unzip the package in an empty directory
2. Open up wp-config-sample.php with a text editor like WordPad or similar and fill in your database connection details
3. Save the file as wp-config.php
4. Upload everything.
5. Launch /wp-admin/install.php in your browser. This should setup the tables needed for your blog. If there is an error, double check your wp-config.php file, and try again. If it fails again, please go to the support forums with as much data as you can gather.
6. Note the password given to you.
7. The install script should then send you to the login page. Sign in with the username admin and the password generated during the installation. You can then click on 'Profile' to change the password.

Upgrading

Before you upgrade anything, make sure you have backup copies of any files you may have modified such as index.php.

Upgrading from any previous WordPress to 1.5:

1. Delete your old WP files, saving ones you've modified
2. Upload the new files
3. Point your browser to /wp-admin/upgrade.php
4. You wanted more, perhaps? That's it!

Template Changes

If you have customized your templates you will probably have to make some changes to them. If you're converting your 1.2 or earlier templates, we've created a special guide for you.

Online Resources

If you have any questions that aren't addressed in this document, please take advantage of WordPress' numerous online resources:

The WordPress Codex

The Codex is the encyclopedia of all things WordPress. It is the most comprehensive source of information for WordPress available.

The Development Blog

This is where you'll find the latest updates and news related to WordPress. Bookmark and check often.

WordPress Planet

The WordPress Planet is a news aggregator that brings together posts from WordPress blogs around the web.

WordPress Support Forums

If you've looked everywhere and still can't find an answer, the support forums are very active and have a large community ready to help. To help them help you be sure to use a descriptive thread title and describe your question in as much detail as possible.

WordPress IRC Channel

Finally, there is an online chat channel that is used for discussion amoung people who use WordPress and occasionally support topics. The above wiki page should point you in the right direction. (irc.freenode.net #wordpresss)

System Recommendations

• PHP version 4.1 or higher
• MySQL version 3.23.23 or higher
• ... and a link to http://wordpress.org on your site.

WordPress is the official continuation of b2/cafélog, which came from Michel V. The work has been continued by the WordPress developers. If you would like to support WordPress, please consider donating.

Upgrading from another system

WordPress can import from a number of systems. First you need to get WordPress installed and working as described above.

XML-RPC Interface

WordPress has an XMLRPC interface. We currently support the Blogger API, metaWeblog API, and the MovableType API.

The metaWeblog and MovableType APIs are currently supported with the following exceptions:

• mt.supportedTextFilters is a dummy stub function that returns an empty string
• keywords are not supported in the MovableType API

Extended entries in the MovableType API are automatically converted to/from the WordPress <!--more--> tag.

You can now post to your WordPress blog with tools like BlogBuddy, Bloggar, WapBlogger (post from your Wap cellphone!), Radio Userland (which means you can use Radio's email-to-blog feature), Zempt, NewzCrawler, and other tools that support the Blogging APIs! :)

Your XMLRPC server/path are as described here: if you login to WordPress on http://example.com/me/wp-login.php, then you have:

• Server: http://example.com/ (some tools will just want the 'example.com' hostname part)
• Path: /me/xmlrpc.php
• complete URL (just in case): http://example.com/me/xmlrpc.php

Post via Email

You can post from an email client! To set this up go to your "Writing" options screen and fill in the connection details for your secret POP3 account. Then you need to set up wp-mail.php to execute periodically to check the mailbox for new posts. You can do it with Cron-jobs, or if your host doesn't support it you can look into the various website-monitoring services, and make them check your wp-mail.php URL.

Posting is easy: Any email sent to the address you specify will be posted, with the subject as the title. It is best to keep the address dicrete. The script will delete emails that are successfully posted.

User Levels

You may allow or disallow user registration in your General options. If "new users can blog" is disabled you must first raise the level of a newly registered user to allow them to post. Click the plus sign next to their name on the Users page.

User Levels

• 0 - New User
• 1 - User can post, edit, and delete their own posts.
• 5+ - Admin; can post, edit, delete other people's posts, and change the options.
• Any user whose level is higher than 1, can edit and delete the posts and change the level of lower users. Example: a level 2 user is not an admin, but can edit the posts of level 1 users, and up the level of a new user from 0 to 1.

Usually you want to have a team of level 1 users except for you.

Final notes

• If you have any suggestions, ideas, comments, or if you (gasp!) found a bug, join us in the Support Forums
• WordPress now has a robust plugin API that makes extending the code easy. If you are a developer interested in utilizing this see the documentation in the wiki. In most all cases you shouldn't modify any of the core code.

Copyright

WordPress is released under the GPL (see license.txt).