changed git call from https to git readonly
[atutor.git] / mods / wordpress / README
1 ## WordPress Integration module for ATutor
2
3 ####################
4
5 **Wordpress needs to be installed and configured before installing this module. See the Wordpress documentation for instruction on installing and configuring Wordpress.
6
7 http://codex.wordpress.org/Installing_WordPress
8
9
10 ####################
11 Installation the ATutor WordPress Module:
12 1. Unzip the atutor_wordpress.x.x.x.zip file into the ATutor mods/ directory to create a "wordpress directory.
13 2. Login to ATutor as the admin, click on the Modules tab then click Install Modules. Wordpress should be listed. Select it and press the Install button.
14 3. Follow the installer instructions.
15 4. Once the module is installed, select the WordPress module now listed in the available modules in the module manager, then press the Enable button. This inserts another main navigation tab above.
16 5. Click the WordPress tab then enter the URL to the base directory under which WordPress is installed, then press the Save button. WordPress should then appear below.
17 6. Next set the database access information for WordPress in the wp_config.php file in the module directory, then save the file. This information is required for the module detailed view to display recent posts on a course home page, or student tools page.
18
19 #####################
20 Authenticate Wordpress Users from ATutor Members
21 To remove the need to setup separate accounts in WordPress and ATutor, you can install the WordPress External DB  Authentication plugin. A copy of the plugin is available in the modules' wp_plugin directory. For details on how to install the plugin, see the link below.
22
23 Plugin details can be found at:
24 http://wordpress.org/extend/plugins/external-database-authentication/
25
26 Note that this is not a single sign-on, but rather just a way to ensure anyone registered in ATutor, is automatically registered in Wordpress. When a user logs into Wordpress for the first time, the member information in ATutor is copied over to WordPress. If you find you are unable to login with an account you know exists in ATutor, review the cookies you have set in your browser, and remove any WordPress related ones. Then try to login again. This problem can occur when you are using more than one ATutor account to access Wordpress.
27
28 Note also that you will probably want to install this ATutor Wordpress plugin before you start using Wordpress. Otherwise you will need to recreate any Wordpress accounts in ATutor. Once the module is installed, Wrodpress users are no longer able to modify their Wordpress account information.