The process for installing your own WordPress site on OpenShift is described below.
Create an account on OpenShift
The first step is to create an account on OpenShift by Redhat. This is a cloud service provider which offers a free tier for hosting a limited number of open source software applications.
- Visit the OpenShift website
- Register a free tier account.
- Confirm the email you used to register your account (check your inbox, or spam folder and follow the instructions.)
Install the OERu WordPress image
- Login to OpenShift (Username is the email account you used to register).
- Click the Add Application… button
- In the Instant App section choose WordPress 4
- Enter a sub-domain name for the public url of your WordPress site. This is associated with your account name and will be the url you use to visit your WordPress site. It is a good idea to pick a short mnemonic or acronym related to your course.
- Set the Source Code field to the url of the Github repository for the OERu WordPress image: https://github.com/oeru/openshift-wordpress (The OERu has created a source code image of WordPress for OpenShift which includes the OERu theme plugin.) Leave the branch/tag field untouched.
- There is no need to change any of the other settings.
- Scroll down and click on the “Create application” button.
- It will take a few minutes for the installation setup process to complete. Wait until the screen changes to display the username and password for your database. Most learners will not need to configure their database at any time. Should this be required, you can retrieve the username and password from your administration console.
- The first step of your installation is complete.
Setup your WordPress administration details
This is a simple process to setup your administration login details for WordPress to complete the installation
- Login to OpenShift and go to your “Applications tab”.
- Click on the link of the WordPress application you installed in the previous step.
- From the application management window, click on the WordPress application link. This will launch the next steps for completing the setup of your administration login details.
- Choose the language for your WordPress installation.
- Choose an Administration username. This is the username which will provide access to the full administration privileges of your WordPress site.
- Choose a password and retype (you will need to remember your password)
- Enter your email address.
- Scroll down and click on the “Install WordPress” button.
- This will direct you to the login screen for your WordPress application.
- Enter your Admin username and corresponding password.
- From your Dashboard you will be able to visit the site.
- One setting you will want to verify after a fresh installation (remember to use WordPress’s Save Changes button after changing each configuration page on the Dashboard):
- Settings… Permalinks should be set to Post name
- Logout of your WordPress (hover your cursor over your username on the top right-hand side of your screen, and select “Log Out”).
- Go back to the url of your WordPress site. Append “wp-admin” after the public address of your site – this is needed to access the login page. (For example “http://mycourse-mackiwg.rhcloud.com/wp-admin”) Bookmark this page so you don’t forget the login url.
Run the script to harvest your outline of WikiEducator pages
These instructions cover the process for running the script and creating the navigation menu in wordpress
- Go to your course outline page in WikiEducator. Use the Edit Source feature to open the wikitext of your outline and at the top insert:
- Adjust the URL in the widget text above for the WordPress site you created. Save the modified page.
- At the top of your course outline page there should now be a Request snapshot button. When clicked, it will pop up a dialog box where you must supply your WordPress username and password. Then click the Push snapshot to WordPress button. This will queue your snapshot request. Please be patient. It will take several minutes for the script to process your course. (In fact rather than just waiting around, if you have confirmed your email address in the WikiEducator Preferences you will receive an email when the script successfully completes.)