01.12.2012 Views

7 Components: the Function Pages - Developers

7 Components: the Function Pages - Developers

7 Components: the Function Pages - Developers

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

You will see that <strong>the</strong> characters from <strong>the</strong> smilies plugin have turned<br />

into smilies. You can find a more detailed list of possible graphics in<br />

<strong>the</strong> description page having <strong>the</strong> name TWiki.SmiliesPlugin. This<br />

kind of documentation is issued with every plugin, and we recommend<br />

looking at it before using <strong>the</strong> plugin.<br />

Because <strong>the</strong>re is such a wealth of add-on programs for TWiki<br />

(currently 135), we cannot discuss all of <strong>the</strong>m here. A few are<br />

needed in Section IV, where we will have a closer look at <strong>the</strong>m.<br />

However, our primary focus right now is <strong>the</strong> process of installing<br />

new plugins. It is a relatively easy task. On <strong>the</strong> overview page<br />

http://twiki.org/cgi-bin/view/Plugins/PluginPackage, you will find<br />

<strong>the</strong> entire list of installable plugins. Each one has its own topic.<br />

There, you can find directions for using <strong>the</strong> plugin, updated tips,<br />

and, most importantly, <strong>the</strong> installation instructions. Generally, you<br />

only need to download <strong>the</strong> archived file attached to <strong>the</strong> end of <strong>the</strong><br />

topic and unpack it to <strong>the</strong> TWiki installation directory. This procedure<br />

will automatically copy <strong>the</strong> files to <strong>the</strong>ir correct directories.<br />

Cautious webmasters can also unpack <strong>the</strong> files to a temporary directory.<br />

A directory structure will be generated that is analogous to that<br />

of <strong>the</strong> TWiki directory, and you will know which files are to be copied<br />

to which directories.<br />

Caution: A few plugins must additionally be configured on <strong>the</strong> file<br />

level. To do this, carefully read <strong>the</strong> corresponding installation instructions.<br />

All plugins are activated automatically as soon as <strong>the</strong>y are installed.<br />

However, you can prevent a plugin from being activated by adding it<br />

to <strong>the</strong> list of DISABLEDPLUGINS in TWiki.TWikiPreferences.<br />

Unfortunately, we cannot provide a universal recipe for <strong>the</strong> installation<br />

of add-ons. Often, <strong>the</strong>y are simple programs that you can ei<strong>the</strong>r<br />

execute from your computer or server. A few of <strong>the</strong>se programs<br />

require Java J2EE to be installed on your computer. You can<br />

download it at http://java.sun.com. Just follow <strong>the</strong>ir installation instructions.<br />

We would like to highlight one particular add-on, since it can<br />

make working with TWiki much easier. It is <strong>the</strong> FirefoxExtension-<br />

AddOn, which can be found at <strong>the</strong> URL http://twiki.org/cgibin/view/Plugins/FirefoxExtensionAddOn.<br />

If you use Firefox as<br />

your browser, this add-on gives you <strong>the</strong> option of inserting several<br />

TWiki formatting commands via a toolbar or context menu. You can<br />

install <strong>the</strong> add-on directly from <strong>the</strong> page indicated from Firefox.<br />

Then you just need to restart <strong>the</strong> browser, and you should see <strong>the</strong><br />

Installing<br />

Plugins<br />

16.3 Plugins and Add-ons �<br />

�<br />

�<br />

251<br />

FirefoxExtension

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!