-
Notifications
You must be signed in to change notification settings - Fork 5
Home
Wiki
Introduction
The ExpressionEngine Wiki Module provides a powerful wiki that integrates seamlessly with ExpressionEngine. See Getting Started with the Wiki for a more detailed explanation of what a wiki is and what you can do with it. The Wiki Module requires the installation of ExpressionEngine to function.
- Integrates with ExpressionEngine's Membership Module
- Supports multiple wikis on a single ExpressionEngine installation
- Namespace support with unique editing and admin restrictions permissions
- Add pages by going to http://example.com/index.php/wiki/index/NewPage, by using the Find Page search in the sidebar, or creating a link using wiki syntax
- Admins can easily delete articles and categories
- Edit the content of existing pages
- View the history of previous revisions of a page
- Redirect a page to another page (Admins)
- Lock a page to prevent further editing (Admins)
- Moderate a page to accept only approved revisions (Admins)
- Notify moderators by email
- Special Pages for Recent Changes, Searching, Atom/RSS, File Uploads, and a full Title List
- Easy to use nested categories
- Template-based themes
First-Time Setup
-
Upload the system/user/addons/wiki folder to your system/user/addons/ folder.
-
Upload the themes/user/wiki_themes folder to your themes/user/ folder.
-
Login to your ExpressionEngine control panel and go to 'Developer Tools - Add-On Manager' and install the wiki.
-
Click on Wiki to open the Wiki Module Control Panel and then create a wiki and configure the preferences.
-
Go into the Templates section of your ExpressionEngine Control Panel. Create a Template Group specifically for your wiki and in the 'index' template place a tag with a format similar to:
{exp:wiki base_path='Template_Group/index' wiki="wiki_short_name" theme="default"}
For example, lets say you created a Template Group for your wiki called "wiki", your wiki's short name is "default_wiki," and you are using the default theme. If that's the case your tag would look like this:
{exp:wiki base_path='wiki/index' wiki="default_wiki" theme="default"}
Do not enable caching on the template containing the Wiki module tag.
That's it! Point your browser to the 'wiki/index' template to view your wiki. Keep reading for more information on the wiki tag.
Wiki Tag
The Wiki module only has one tag that is used in a ExpressionEngine Template:
{exp:wiki}
This tag is placed in the index template of the Template Group that you are using for your wiki as described above in the First-Time Setup instructions. The tag displays the wiki within the specified ExpressionEngine template.
Modifying the wiki's theme (visual design) is described in the Wiki Theme Template section of the User Guide.
{exp:wiki base_path='wiki/index'}
The template_group/template location of the Wiki tag in your site. This parameter is used for creating all links in the Wiki, so make sure it is correct.
This is a required parameter.
When this parameter is used, you can direct the member paths from the default member area of your ExpressionEngine installation to the Discussion Forum member area.
The value for the profile_path='' parameter is the template_group/template or trigger word for your Discussion Forum. The variable will then create the URL automatically.
For example if you had this in the wiki tag:
{exp:wiki profile_path='site/my_forum'}
The {path:register} variable would render:
http://example.com/index.php/site/my_forum/member/register/
Here is an example using the Discussion Forum trigger word:
{exp:wiki profile_path='forums'}
The {path:register} variable would render:
http://example.com/index.php/forums/member/register/
{exp:wiki theme="default"}
The theme to use for your Wiki. Themes are located in the themes/wiki_themes/ directory. The parameter specifies the name of your theme's folder and that folder's theme file. This means that a theme's folder and its main php file will match. For example the default theme structure is default/default.php so the parameter would be default. See the Wiki Templates section for more information on themes.
{exp:wiki wiki="default_wiki"}
Use the Short Name of the wiki you want to display in the template. You can only specify one wiki in this parameter.
Control Panel and Templates
Using the Wiki
All page creation, category creation, and editing is done by users directly on the wiki using special wiki syntax.
Update Notes
- Version 3.0.2 -- Fixed an error when viewing the uncartagarized page that occurred due to a deprecated DISTINCT query.
- Version 3.0.1 -- Added travis/composer.json for linting and lock file for this version.
- Version 3.0 -- ExpressionEngine v3 compatible
- Version 2.0 -- ExpressionEngine v2 compatible -- Trailing Slashes Removed from URLs
- Version 1.2 -- Edit Previews -- Associated Pages, i.e. What Links Here? -- Uncategorized Pages
- Version 1.1 -- Namespace Support Added