Setting Up an Internal Wiki for Our Site

To set up a wiki for the OpenConcept site, I followed instructions on how to set up a wiki with Drupal 5 (an archived version of the instructions here ).

Below, I indicate which of those instructions I followed, and where I deviated from the instructions. In any case where I deviated from the instructions, I have indicated this with CAPITAL LETTERS.

Note that there is one patch that was applied, which affects the img_assist module and the pearwiki_filter module.

Prerequisites

• Install Drupal 5
• Download and install contributed modules
  • ALREADY INSTALLED diff
  • ALREADY INSTALLED image
  • ALREADY INSTALLED, BUT NOT ENABLED (ENABLED IT) img_assist: Apply the patch on the module to make it work with Mediawiki syntax
  • ALREADY INSTALLED pathauto
  • PEAR wiki filter: follow the directions in the readme to install PEAR packages
  • Recent changes
  • Template filter - attached below but originally from tschannen.net
  • ALREADY INSTALLED, EXCEPT FOR VIEWS_RSS views
  • Wiki tools

Enable modules

Go to administer > site building > modules and activate the following modules:

• Core - optional
  • ALREADY INSTALLED blog (if you want blogs for your users)
  • ALREADY INSTALLED, THOUGH DOESN'T APPEAR TO BE USED ON THE OPENCONCEPT SITE book (if you need a book style part of your website)
  • ALREADY INSTALLED path
  • ALREADY INSTALLED search
  • ALREADY INSTALLED upload
• Other
  • ALREADY INSTALLED Diff
  • ALREADY INSTALLED Pathauto
  • PEAR wiki filter
  • Recent changes
  • Template filter
  • Wikitools
• Views
  • ALREADY INSTALLED Views
  • ALREADY INSTALLED Views UI
  • Views RSS

Node types

Go to administer > content > content types and add new content types:

Wiki pages

• Name = Wiki Page
• Type = wiki
• Description = A wiki page can be edited by all users.
• Workflow options:
  • uncheck Promoted to front page
  • check Create new revision

Templates

• Name = Template
• Type = template
• Description = A template can be used in other pages as replacement.
• Workflow options:
  • uncheck Promoted to front page
  • check Create new revision

Other node types

Depending on your needs, you can set other node types like blog, page, story and image also to create new revisions.

Access rules

Go to administer > users > access control and give the xxxauthenticatedxxx OC user role the following permissions:

• blog module:
  • ALREADY CHECKED edit own blog
• book module:
  • DIDN'T ADD PERMISSION create book pages
  • DIDN'T ADD PERMISSION edit book pages
  • DIDN'T ADD PERMISSION edit own book pages
• comment module:
  • ALREADY CHECKED access comments
  • ALREADY CHECKED post comments withouht approval
• image module:
  • create images
  • edit own images
  • view original images
• img_assist module:
  • access all images
  • access img_assist
  • use original size
• node module:
  • access content
  • create wiki content
  • edit own wiki content
  • edit wiki content
  • DIDN'T ADD PERMISSION create template content
  • DIDN'T ADD PERMISSION edit own template content
  • DIDN'T ADD PERMISSION edit template content
  • ALREADY CHECKED view revisions
• search module:
  • ALREADY CHECKED search content
  • ALREADY CHECKED use advanced search

Give the xxxauthenticatedxxx ADMIN user role the following permissions:

• nodeaccess module:
  • administer nodeaccess
  • grant node permissions
  • grant own node permissions

• img_assist module:
  • access advanced options
  • access all images
  • access img_assist
  • use original size

• node module:
  • create template content
  • create wiki content
  • edit own template content
  • edit own wiki content
  • edit template content
  • edit wiki content

Wikitools

Go to administer > site configuration > wikitools and set the following options:

• Wikipath: locate
• Title of main page: Main Page
• ONLY ADD 'WIKI PAGE' TYPE HERE (NOT THE OTHER TYPES): Wiki node types: select Blog entry, Page, Story, Wiki Page
  • If you have other content types for you site, you can select them too. The image and template types are not needed.
• Options:
  • Select the options depending on your needs. If you want to allow different pages with the same name - for example a blog entry and a wiki page with the same name - then deselect the Unique Titles option. If users should be able to change the node titles then deselect the Move Protection option.

Input format

Go to administer > site configuration > input format and create a new input format:

• Name = Mediawiki
• Filters:
  • PEAR Wiki Filter
  • Template Filter

NO. DON'T: Select the newly created format and set it the default format.

Click configure on the Mediawiki format. And then the Rearrange Tab. Give PEAR Wiki filter a weight of and the Template filter a weight of 3 and save.

Click the Configure Tab and setup the following options:

• PEAR Wiki filter:
  • Path of PEAR packages: If you don't see the available formats alredy, set the path to the Text_Wiki PEAR package.
  • Format: Mediawiki
  • Ignore regexp: #(?<!{){{(?!})([^}]|(}}}))*(?<!{)}}(?!})#s
  • Use wikilinks: yes
  • Use wikitools: yes
  • Interwiki mapping: Set desired interwiki links
  • Use image module: yes
• Template filter:
  • Node type for templates: Template

Image attach

Go to administer > site configuration > image assist and set the following options:

• Other properties:
  • Default link behaviour: Link to image page
  • Default insert mode: Mediawiki (if this option does not show up, make sure the patch is applied correctly)

Set other options as desired.

Pathauto

Go to administer > site configuration > pathauto and set the following options:

• General settings:
  • ALREADY SET Separator: _
  • Strings to remove: remove all entries
• Node path settings:
  • NO. LEAVE IT AS IS. Default pattern: none
  • Pattern for Blog entry pages: blog/[user]/[title] (if blog module activated)
  • Pattern for Book pages: [book]/[title] ((if book module activated)
  • Pattern for Wiki pages: wiki/[title]

Set other options as desired.

Views (NOTHING TO DO HERE... NO INSTRUCTIONS)

All pages

...

Images

...

Templates

...

Theme

Go to administer > site building > themes and select the Configure tab.

• Display post information
  • uncheck Wiki pages and DON'T CHECK Book pages (if you have book module enabled)</s>

NO. SKIPPED THIS STEP. Syntax highlighting

If syntax highlighting is needed, install the [/freelinking/GeSHi+filter GeSHi filter] module and enable it on the Mediawiki input format. Then go to administer > site configuration > geshi filter and set the desired options. Make sure to check the Try to auto-configure other filters. If problems arise, make sure that the activated filters in the Mediawiki format have the order:

1. PEAR wiki filter
2. Template filter
3. GeSHi filter

NO. SKIPPED THIS STEP. Talk pages

If you want talk pages, install the [/freelinking/Talk+Pages Talk Pages] module. This module will break direct links to comments, for example from the recent changes module!

NO. SKIPPED THIS STEP. Known problems

Due to a bug in Drupal the revisions are not working correctly at the moment. See this issue: http://drupal.org/node/114822 for the patch.</s>

CHANGE ACCESS CONTROL FOR NODEACCESS MODULE

• enable nodeaccess module
  • (NOTE that this is not a production version for Drupal5 yet -- still beta, essentially)
• admin/user/nodeaccess
  • add "View", "Edit", and "Delete" permissions for "OC" and "Admin" users, for wiki pages.
  • remove "View" permission, for wiki pages for all other users

USEFUL LINKS

• mediawiki format
  • http://meta.wikimedia.org/wiki/Cheatsheet
• convert html to mediawiki format
  • http://diberri.dyndns.org/wikipedia/html2wiki/

Attachment	Size
template_filter_0.tgz	2.31 KB