Did you know that you can publish your wiki pages through WordPress? You get the collaborative aspects of the wiki with the styling and publishing options of WordPress. Since it's pulling the content directly from the wiki, it will also automatically update! This is not restricted to UBC Wiki either. You can pull any page from any wiki using MediaWiki (such as wikipedia).

Contents

Installing Wiki Embed

  1. Download the Wiki Embed plugin from the WordPress plugin page.
  2. Upload the wiki-embed folder into your /wp-content/plugins/ directory.
  3. Activate the plugin through your plugins menu.

Wiki Embed Settings

There are also a number of options (see the documentation page for more information) that you can change. Here are some suggestions:

See below for more information on using the Target URL option when Internal wiki links open as a WordPress page.

Wiki Page Tips

When creating or modifying a wiki page, it is best to keep a few things in mind when you expect to use it in WordPress through wiki embed.

Also keep in mind that changes on the wiki will appear immediately on the wiki, but depending on the wiki embed settings in WordPress, it may take anywhere from 5 minutes to never for changes to appear.

Wiki in WordPress

Inserting Wiki Pages in WordPress

In order to insert wiki pages, you will need to have access to the WordPress pages section. This usually means you need to have editor or admin access (though it depends on the site settings).

  1. Add New Page (or use existing one).
  2. Click on the Wiki Embed icon. (The [[ ]] icon just above where it says Wiki Embed.)
    Screenshot of wiki embed icon in WordPress
  3. Copy and paste the full wiki page link (including the http part) into the box. (See the CLF Documentation for an example.)
  4. Choose your options. First one is tabs on/off, second is to not show the table of contents, and third is for links to edit the wiki page.

Remember that the wiki embed function is like an "insert" function, which means that you can have things in the WordPress page before and after if you wish.

Setting Target URLs

If you have the 'Internal Wiki Links' opens as WordPress page option, then you will want to set target URLs for any internal wiki links on your pages, meaning that if someone clicks on a wiki link, it will open a page that you specify instead.

  1. Go to Dashboard>Wiki Embed>Settings
  2. Under Global Settings, choose WordPress Page — links open a WordPress page with the content of the wiki for the internal links option.
  3. Embed a wiki page as discussed above.
  4. View the WordPress page where you have embedded wiki content.
  5. Click on the internal wiki link(s), which will open the wiki page in a sort of temporary WordPress page. Do this for all internal wiki links.
  6. Scroll down to the bottom of each temporary Wordpress page. If you do not want this temporary page to be part of your WordPress site, click on "in Wiki Embed List" and skip ahead to step 8; otherwise, click on "Create a New Page." In Edit mode, change the title of the page, update the wiki embed source if necessary, and set page attributes such as parent and order to make sure the page is located where it should be in the site architecture.
  7. Click on Wiki Embed then Wiki Embed List in your WordPress menu. You should see a list of internal wiki links on your WordPress site. Such as,
    WP Wiki Embed List.jpg
  8. Add a Target URL for each internal wiki link. The target URL is a sort of redirect, so you set "when someone clicks on this wiki link, go to this specified page". The link can be either a relative link (within the WordPress site, see above image) or an external URL, for example, a URL that points back to the original wiki page.

The wiki embed list will have a full list of wiki pages including all the pages you are embedding. You do not need to set a Target URL for pages you have embedded, only the internal wiki links.

In case you missed any, there is an option to enter an e-mail for notification when a new temporary WordPress page is created so that a target URL can be added. (As of March 2011, however, it is still under development and the person may be notified of links other than internal wiki links.)

Wiki Cache

When wiki content is embedded in WordPress, wiki embed caches or stores a copy. Depending on the Wiki Embed settings, how long this copy is stored until a new version is loaded from the wiki will differ, which you can find out from the Wiki Embed list's 'Cache Expires in' and at the bottom of a page using wiki embed. WordPress page wiki embed options

Clear Cache

There are two ways to clear this stored copy so that the newest copy of the wiki page is loaded.

  1. Click on "Refresh Wiki Content" at the bottom of a WordPress page using wiki embed (as in the above screenshot).
  2. Select the relevant pages in the Wiki Embed List and under 'Bulk Action', select 'Clear Cache' and hit 'Apply'.