snippets plugin

This plugin adds a new button to editor toolbar. When clicking on it a popup shows up, showing a list of page templates which can be previewed and inserted into the editor window. The list of templates is defined using a Wiki page which contains a simple unordered list of links to pages which should be used as templates.

Download and install the plugin using the Plugin Manager using the following URL. Refer to Plugins on how to install plugins manually.

• .tgz Plugin Manager

You can also install the plugin using git:

% cd <dokuwiki>/lib/plugins
% git clone git://github.com/cosmocode/dokuwiki-plugin-snippets.git snippets

IMPORTANT: You have to invalidate/delete the cache before the new button appears in the toolbar.

You can specify the wiki page which defines the list of page templates, defaults to snippets.

Just create the page you configured in the configuration manager (defaults to snippets) and add your list of template pages (nothing else). Then create your template pages as well and you're ready to go (you might want to save all your templates in a dedicated namespace so you can use the hidepages option to hide them in the index etc.).

You can use the following syntax inside your template to provide additional comments which will get stripped out when you insert the template into the current page you're editing.

<snippet>
Additional comments, i.e. you have to provide the following information:

  * foo
  * bar
</snippet>

Please report bugs and feature requests at the bug tracker.

A complete changelog is available here.

• updated date in plugin-info (2012/02/28 09:42)
• little style improvements (2012/02/07 17:16)
• changed to jQuery (2012/02/07 17:15)
• added finish translation (2010/09/25 12:04)
• release preparations (2010/01/04 20:36)
• use new plugin.info.txt (2010/01/04 20:35)
• fixed icon issues with cannonical option (2010/01/04 20:23)
• release preparations (2009/05/11 10:45)
• removed DOKU_BASE from popup URL ... DOKU_BASE is added in the javascript that handles the popup already (2009/05/11 10:45)
• Revert "fixed popup URL" (2009/05/06 16:06)

Don't post bug report here, use the bug tracker instead.

The hint “to clean the cache or to invalidate it”, didn't help much. (deleting files in cache, attic, etc. folders didn't show any effect; neither before nor after installation or visiting page)

What reproducibly worked:

1. unpack clean installation
2. copy plugin in plugin-folder
3. create a page “snippets” with a bullet-list in the page-folder (root)
4. run install.php
5. when open editing mode you should see the icon

hint: just move the user data to new version and everything's fine.

annotation: in general “icon-editing plugins” are easy to install

If the template icon does not show up in the toolbar, follow these steps:

Make sure the page snippets has this content:

  * templatepagename

Purge the javascript cache by following the instructions on purging_the_cache

Purging the cache in your browser is typically done by pressing CTRL-F5 or ALT-F5.

use indexmenu-plugin to create an unordered list:

{{indexmenu>.|tsort context id#2}}

The files are stored in the configured folder/ subfolders, e.g.

/templates
 orderform.txt
 contentview.txt
/plugins
 acl.txt
 indexmenu.txt
 ...
/<further folders>