Wordpress installation and configuration: Difference between revisions

The educational technology and digital learning wiki
Jump to navigation Jump to search
Line 44: Line 44:
* password = rumpelstilskin
* password = rumpelstilskin


=== Base installation ===
=== Wordpress installation ===


; Download and put code in place
; Download and put code in place
Line 58: Line 58:
(1) Rename the wp-config-sample.php file to wp-config.php. Make sure to get it right !
(1) Rename the wp-config-sample.php file to wp-config.php. Make sure to get it right !


(2)  Edit this file (''wp-config.php'') in a [[text editor]]. Do not use Word or Notepad. Enter information below and adapt to database name and database user name that you just defined above.
(2)  Edit this file (''wp-config.php'') in a [[text editor]]. Do not use Word or Notepad ! Change information below, i.e. adapt to database name and database user name that you just defined above.


Base information:
Base information:
Line 89: Line 89:
</source>
</source>


Watch out: These keys must be enclosed in quotes ' .... '. Do not use quotes inside the keys, or php will be confused.
'''Watch out:'''
* Both arguments of the ''define'' must be enclosed in quotes ' .... ' and each one must finish with semi-colon. Also, do not use quotes inside the security keys, else php will be confused.
define ('constant', 'value');
* For programmers who don't know PHP: ''define'' just defines a named constant at runtime.
* If you only own a single database and already have a wordpress installed, you also need to change the prefix below
 
So double check what you did and then save the file.
 
; Run the installer script
 
(1) Access wp-admin/install.php from your webbrowser. E.g. on your local test server the URL might be something like:
http://localhost/blog/
You actually will be redirected to the following page:
  http://localhost/blog/wp-admin/install.php
 
Remark: If you can't see the page or get an error message, please fix the syntax mistakes you just made before. I you can't find it yourself, look at the server log. E.g. open file ''c:\...\apache2\logs\error.log''
 
(2) Provide a name for the blog and an email address
* Make absolutly sure to copy/paste the generated password to a safe place !!
 
(3) Log in
 
.... enjoy :)
 
== Configuration ==
 
Read:
* [http://codex.wordpress.org/First_Steps_With_WordPress First Steps With WordPress] followed by [http://codex.wordpress.org/Administration_Panels Administration Panels]
* [http://codex.wordpress.org/New_To_WordPress_-_Where_to_Start New To WordPress - Where to Start]
* look up a chapter in the [http://codex.wordpress.org/Working_with_WordPress Working with WordPress] manual, part of the [http://codex.wordpress.org/Getting_Started_with_WordPress Getting Started with WordPress]
 
If you log in as admin, you will automatically see the dashboard
 
[[image:wordpress-dashboard-291.jpg|frame|none|Wordpress dashboard 2.9.1]]
 
From the [http://codex.wordpress.org/Administration_Panels#The_Dashboard official Administration Panel] article, retrieved 17:32, 19 January 2010 (UTC), we reproduce: {{quotation|Each Panel, referred to as SubPanel, that is accessed via the main navigation menu, is presented in the boxes below. The links in those boxes will lead you to sections of this article describing those SubPanels. From those sections, you can navigate to articles detailing more information about each SubPanel}}
(Links will lead to the codex.wordpress web site.).
 
<table cellspacing="10" width="100%">
 
 
<tr valign="top">
<td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="20%">
<p><a href="#Dashboard_-_Information_Central" title="">Dashboard</a>
</p>
</td><td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Posts_-_Make_some_content" title="">Posts</a>
</p>
 
<ul><li><a href="#Edit_Posts" title="">Edit</a>
</li><li><a href="#Add_New_Post" title="">Add New</a>
</li><li><a href="#Tags" title="">Post Tags</a>
</li><li><a href="#Categories" title="">Categories</a>
</li></ul>
</td><td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Media_-_Add_pictures_and_movies_to_your_posts" title="">Media</a>
</p>
<ul><li><a href="#Media_Library" title="">Library</a>
</li><li><a href="#Upload_New_Media" title="">Add New</a>
 
</li></ul>
</td><td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Links_-_Putting_the_Inter_in_the_Internet" title="">Links</a>
</p>
<ul><li><a href="#Edit_Links" title="">Edit</a>
</li><li><a href="#Add_New_Link" title="">Add New</a>
</li><li><a href="#Link_Categories" title="">Link Categories</a>
</li></ul>
</td><td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Pages_-_Your_Static_Content" title="">Pages</a>
</p>
<ul><li><a href="#Edit_Pages" title="">Edit</a>
 
</li><li><a href="#Add_New_Page" title="">Add New</a>
</li></ul>
</td><td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Comments_-_Reader_Feedback" title="">Comments</a>
</p>
</td></tr>
<tr valign="top">
<td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Appearance_-_Change_the_Look_of_your_Blog" title="">Appearance</a>
</p>
<ul><li><a href="#Manage_Themes" title="">Themes</a>
</li><li><a href="#Widgets" title="">Widgets</a>
 
</li><li><a href="#Edit_Themes" title="">Editor</a>
</li><li><a href="#Install_Themes" title="">Add New Themes</a>
</li><li><a href="#Customize_Header" title="">Header Image and Color</a>
</li></ul>
</td><td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Plugins_-_Add_Functionality_to_your_Blog" title="">Plugins</a>
</p>
<ul><li><a href="#Manage_Plugins" title="">Installed</a>
</li><li><a href="#Install_Plugins" title="">Add New</a>
</li><li><a href="#Edit_Plugins" title="">Editor</a>
 
</li></ul>
</td><td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Users_-_Your_Blogging_Family" title="">Users</a>
</p>
<ul><li><a href="#Authors_.26_Users" title="">Authors &amp; Users</a>
</li><li><a href="#Add_New_User" title="">Add New</a>
</li><li><a href="#Your_Profile" title="">Your Profile</a>
</li></ul>
</td><td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Tools_-_Managing_your_Blog" title="">Tools</a>
 
</p>
<ul><li><a href="#Tools_-_Turbo_and_Press_This" title="">Tools</a>
</li><li><a href="#Import" title="">Import</a>
</li><li><a href="#Export" title="">Export</a>
</li><li><a href="#Upgrade" title="">Upgrade</a>
</li></ul>
</td><td bgcolor="#fff3f3" style="border:1px solid #ffc9c9; padding: 0.5em 1em 1em; color: black;" width="15%">
<p><a href="#Settings_-_Configuration_Settings" title="">Settings</a>
</p>
<ul><li><a href="#General" title="">General</a>
</li><li><a href="#Writing" title="">Writing</a>
 
</li><li><a href="#Reading" title="">Reading</a>
</li><li><a href="#Discussion" title="">Discussion</a>
</li><li><a href="#Media" title="">Media</a>
</li><li><a href="#Privacy" title="">Privacy</a>
</li><li><a href="#Permalinks" title="">Permalinks</a>
</li><li><a href="#Miscellaneous" title="">Miscellaneous</a>
</li></ul>
</td></tr></table>
 


[[Category: Portalware]]
[[Category: Portalware]]
[[Category: Installation tips]]
[[Category: Installation tips]]

Revision as of 19:32, 19 January 2010

Draft

Please, also read Installing Wordpress. It's fine enough. I only created this article in order to have a shorter piece I could use with a projector in a web applications class - Daniel K. Schneider 16:31, 19 January 2010 (UTC).

Installation

Creating a database

WP needs a MySQL database. The installation procedure will create many tables that should normally sit in their own database.

In practice, you have several situations.

(1) If you have a cheap or free provider or if you have a student account, you only may have access to single database. This means that WP will have to co-exist with other applications. That is not a big problem, since most applications add a prefix to each table. By default, WP will add a 'wp_' prefix to each table.

(2) If you want to install WP with a "normal" shared webhosting provider, then you likely may use several databases. Consult the admin interface. Usually there is a tool that allows you to manage databases, e.g. add users and tune permission.

(3) If you have your own MySQL server, then you should install WP in its own database that you'll have to create, i.e.

  • Create a database user (that WP will then use to connect to the database)
  • Create a database that database user can access and fill up with table (and later, data)

In both cases you must create and/or remember:

  • The name of the database
  • The name of the database user
  • The password of the database user
Creating a database and database user with phpMyAdmin

PhpMyAdmin is a popular database management system that is installed with most providers. You may create a new database and user in different orders. The most easiest way is to use the following procedure:

(1) Click on the Privileges tab on the top horizontal menu

(2) Click on Add User at the bottom

  • Then choose a user name, e.g. 'blog'
  • Then select host=local or type localhost
  • Enter the password twice (and remember it)
  • Important: Tick Create database with same name and grant all privileges (this will create a new database)
  • Crucial: Never grant any global privileges on a production server. Each database should have its own life (and hacking attacks).
PhpMyAdmin 3.1.2 User and Database creation

If you do it right you'll have

  • database name = blog
  • database user name = blog
  • password = rumpelstilskin

Wordpress installation

Download and put code in place
  1. Download unzip the WordPress package from http://wordpress.org/download/.
  2. Create a directory somewhere and call it junk
  3. Dezip the package within the junk directory. You will see a directory called wordpress
  4. If you wish to have a different URL on your server, e.g. http://xxxx/blog, then rename the wordpress directory.
  5. Transfer this directory to the web server tree, e.g. via FTP to a provider, to a local "www" directory or somewhere on your local area network.
Edit the configuration file

(1) Rename the wp-config-sample.php file to wp-config.php. Make sure to get it right !

(2) Edit this file (wp-config.php) in a text editor. Do not use Word or Notepad ! Change information below, i.e. adapt to database name and database user name that you just defined above.

Base information:

/** MySQL database username */
define('DB_USER', 'blog');

/** MySQL database password */
define('DB_PASSWORD', 'blog');

/** MySQL hostname */
define('DB_HOST', 'localhost');

/** Database Charset to use in creating database tables. */
define('DB_CHARSET', 'utf8');

/** The Database Collate type. Don't change this if in doubt. */
define('DB_COLLATE', '');

Security (you may skip this step if you test drive WP on a local server on your PC)

In order to make cracking more difficult your wordpress will add extra characters to user's cookies, making it harder to crack encrypted passwords. You only need to do this once and you don't need to type these ever. So use the online generator to generate this salt. Good examples

define('AUTH_KEY', ':dr+%/5V4sAUG-gg%aS*v;&xGhd%{YKC^Z7KKGh j>k[.Nf$y7iGKdJ3c*[Kr5Bg');
define('SECURE_AUTH_KEY', 'TufWOuA _.t>#+hA?^|3RfGTm>@*+S=8\"\4+\"}]<m#+}V)p:Qi?jXLq,<h\\`39m_(');
define('LOGGED_IN_KEY', 'S~AACm4h1;T^\"qW3_8Zv!Ji=y|)~5i63JI |Al[(<YS<2V^$T])=8Xh2a:b:}U_E');
define('NONCE_KEY', 'k1+EOc-&w?hG8j84>6L9v\"6C89NH?ui{*3\\(t09mumL/fFP_!K$JCEkLuy ={x{0');

Watch out:

  • Both arguments of the define must be enclosed in quotes ' .... ' and each one must finish with semi-colon. Also, do not use quotes inside the security keys, else php will be confused.
define ('constant', 'value'); 
  • For programmers who don't know PHP: define just defines a named constant at runtime.
  • If you only own a single database and already have a wordpress installed, you also need to change the prefix below

So double check what you did and then save the file.

Run the installer script

(1) Access wp-admin/install.php from your webbrowser. E.g. on your local test server the URL might be something like:

http://localhost/blog/

You actually will be redirected to the following page:

 http://localhost/blog/wp-admin/install.php

Remark: If you can't see the page or get an error message, please fix the syntax mistakes you just made before. I you can't find it yourself, look at the server log. E.g. open file c:\...\apache2\logs\error.log

(2) Provide a name for the blog and an email address

  • Make absolutly sure to copy/paste the generated password to a safe place !!

(3) Log in

.... enjoy :)

Configuration

Read:

If you log in as admin, you will automatically see the dashboard

Wordpress dashboard 2.9.1

From the official Administration Panel article, retrieved 17:32, 19 January 2010 (UTC), we reproduce: “Each Panel, referred to as SubPanel, that is accessed via the main navigation menu, is presented in the boxes below. The links in those boxes will lead you to sections of this article describing those SubPanels. From those sections, you can navigate to articles detailing more information about each SubPanel” (Links will lead to the codex.wordpress web site.).

<a href="#Dashboard_-_Information_Central" title="">Dashboard</a>

<a href="#Posts_-_Make_some_content" title="">Posts</a>

  • <a href="#Edit_Posts" title="">Edit</a>
  • <a href="#Add_New_Post" title="">Add New</a>
  • <a href="#Tags" title="">Post Tags</a>
  • <a href="#Categories" title="">Categories</a>

<a href="#Media_-_Add_pictures_and_movies_to_your_posts" title="">Media</a>

  • <a href="#Media_Library" title="">Library</a>
  • <a href="#Upload_New_Media" title="">Add New</a>

<a href="#Links_-_Putting_the_Inter_in_the_Internet" title="">Links</a>

  • <a href="#Edit_Links" title="">Edit</a>
  • <a href="#Add_New_Link" title="">Add New</a>
  • <a href="#Link_Categories" title="">Link Categories</a>

<a href="#Pages_-_Your_Static_Content" title="">Pages</a>

  • <a href="#Edit_Pages" title="">Edit</a>
  • <a href="#Add_New_Page" title="">Add New</a>

<a href="#Comments_-_Reader_Feedback" title="">Comments</a>

<a href="#Appearance_-_Change_the_Look_of_your_Blog" title="">Appearance</a>

  • <a href="#Manage_Themes" title="">Themes</a>
  • <a href="#Widgets" title="">Widgets</a>
  • <a href="#Edit_Themes" title="">Editor</a>
  • <a href="#Install_Themes" title="">Add New Themes</a>
  • <a href="#Customize_Header" title="">Header Image and Color</a>

<a href="#Plugins_-_Add_Functionality_to_your_Blog" title="">Plugins</a>

  • <a href="#Manage_Plugins" title="">Installed</a>
  • <a href="#Install_Plugins" title="">Add New</a>
  • <a href="#Edit_Plugins" title="">Editor</a>

<a href="#Users_-_Your_Blogging_Family" title="">Users</a>

  • <a href="#Authors_.26_Users" title="">Authors & Users</a>
  • <a href="#Add_New_User" title="">Add New</a>
  • <a href="#Your_Profile" title="">Your Profile</a>

<a href="#Tools_-_Managing_your_Blog" title="">Tools</a>

  • <a href="#Tools_-_Turbo_and_Press_This" title="">Tools</a>
  • <a href="#Import" title="">Import</a>
  • <a href="#Export" title="">Export</a>
  • <a href="#Upgrade" title="">Upgrade</a>

<a href="#Settings_-_Configuration_Settings" title="">Settings</a>

  • <a href="#General" title="">General</a>
  • <a href="#Writing" title="">Writing</a>
  • <a href="#Reading" title="">Reading</a>
  • <a href="#Discussion" title="">Discussion</a>
  • <a href="#Media" title="">Media</a>
  • <a href="#Privacy" title="">Privacy</a>
  • <a href="#Permalinks" title="">Permalinks</a>
  • <a href="#Miscellaneous" title="">Miscellaneous</a>