Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary wiki Template:Article summary wiki Template:Article summary wiki Template:Article summary wiki Template:Article summary end
Wordpress is the goto Free Libre Open Source Software (FLOSS) content managment system (CMS) created by Matt Mullenweg and first released in 2003. Wordpress has a vast and vibrant community that provides tens of thousands of free plugins and themes to allow the user to easily customize the appearance and function of their Wordpress CMS. Wordpress is licensed under the GPLv2.
The biggest feature of Wordpress is its ease in configuration and administration. Setting up a Wordpress site takes five minutes. The Wordpress administration panel allows users to easily configure almost every aspect of their website including fetching and installing plugins and themes. Wordpress provides effortless automatic updates.
The configuration method used here assumes you are using Wordpress on a local network.
Make sure your
/etc/hosts file is setup correctly. This will be important when accessing your Wordpress CMS from a local network. Your
/etc/hosts file should look something like the following,
#<ip-address> <hostname.domain.org> <hostname> 127.0.0.1 lithium.kaboodle.net localhost lithium ::1 lithium.kaboodle.net localhost lithium
You will need to create a config file for apache to find your Wordpress install. Create the file and edit it your favorite text editor:
Alias /wordpress "/usr/share/webapps/wordpress" <Directory "/usr/share/webapps/wordpress"> AllowOverride All Options FollowSymlinks Order allow,deny Allow from all php_admin_value open_basedir "/srv/:/tmp/:/usr/share/webapps/:/etc/webapps:$ </Directory>
/wordpress in the first line to whatever you want. For example,
/myblog would require that you navigate to
http://hostname/myblog to see your Wordpress website.
Next edit the apache config file and add the following:
... Include conf/extra/httpd-wordpress.conf ...
Now restart apache
# rc.d restart httpd
Mysql can be configured using a plethora of tools, but the most common are the command line or phpMyAdmin.
See phpMyAdmin to install and configure phpMyAdmin.
In your webbrowser, navigate to your phpMyAdmin host and perform the following steps:
- Login to phpMyAdmin.
- Click "user" and then click "Add user".
- Give the popup window a name and a password.
- Select "Create database with same name and grant all privileges".
- Click the "Add user" button to create the user.
Once you have spent a couple of hours setting up your http server, php, and mysql, it is finally time to let Wordpress have its five minutes and install itself. So let us begin.
The Wordpress installation procedure will use the URL in the address field of your web browser as the default website URL. If you have navigated to http://localhost/wordpress, your website will be accessable from your local network, but it will be broken in appearance and function.
- Navigate to
- Click the "Create a Configuration File" button.
- Click the "Let's go!" button.
- Fill in you database information created in the previous section
- Click "Submit".
A page will appear saying Wordpress can not write the wp-config.php file. Copy the text in the edit box and open
/usr/share/webapps/wordpress/wp-config.php as root in your text editor. Paste the copied text into the editor and save the file.
Finally, Click "Run the install" and Wordpress will populate the database with your information. Once complete, you will be shown "Success!" page. Click the login button to finish your installation.
Now would be a good time to access your website from all your devices to be sure your Wordpress installation is setup correctly.
Installing a plugin
Installing a theme
Appearance is broken (no styling)
Your Wordpress website will appear to have no styling to it when viewing it in a web browser (desktop or mobile) that does not have its hostnames mapped to ip addresses correctly.
This occurs because you used a url with the hostname of your server, instead of an ip address, when doing the initial setup and Wordpress has used this as the default website URL.
To fix this, you will either need to edit your /etc/hosts file or setup a proxy server. For an easy to setup proxy server, see polipo, or if you want something with a little more configuration, see Squid.