Editing version 6 of page Developing_Plugins (this is the most recent revision)
Use template:
None
API_Template
DevTrack_Template
Version_Template
Developing [[Plugins]] for Aneuch is easy and fun. Plugins are simple PERL scripts that allow you to extend the feature set of Aneuch.
All plugins will reside in a folder called 'plugins' that lives within the $DataDir. Plugin names will end in either '.pl' or '.pm'. If you want to disable a plugin, simply add '.disabled' (or anything, really) to the end of its name and it will not be loaded.
Plugins should have a hash-bang (#!) line at the very top that points at PERL, normally **`#!/usr/bin/perl`**. The next line will say **`package Aneuch;`**. Following that should be a line that says **`push @Plugins`** followed by a string which contains plugin name, version, and a description and link to plugin homepage. An example would be:
**`push @Plugins, "<a href='http://aneuch.myunixhost.com/Plugins_PlainHTML'>plainhtml.pl</a>, version 1.0 - Allows the use of plain HTML pages (instead of markup)";`**
After this, a plugin may begin defining variables and subs as it sees fit.
A plugin may replace a built-in sub by doing the following:
**`*OldMarkup = \&Markup;\\*Markup = \&NewMarkup;`**
And then go on to define sub NewMarkup.
==[[APIs]]==
Aneuch includes several API calls that plugin developers can use. You will find them documented on the page [[APIs]].
==Examples
You can always see examples of real live Aneuch plugins by viewing the [[https://github.com/ajgraves/aneuch/tree/master/plugins|plugins directory]] in the source repository.
----
CategoryDocumentation
This page is a template
Summary:
User name:
Upload a file
By contributing to this wiki, you acknowledge that you waive your right to claim copyright of your individual contributions. The text of this site is uncopyrighted and released to the public domain.
Show markup help Styling **bold **, //italic //, __underline __, --strikethrough--, `teletype ` Headers = Level 1 =, == Level 2 ==, === Level 3 ===, ==== Level 4 ====, ===== Level 5 ===== (ending ='s optional) Lists * Unordered List, # Ordered List, ** Level 2 unordered, ### Level 3 ordered (up to 5 levels, NO SPACES IN FRONT) Links [[Page]], [[Page|description]], [[http://link]], [[http://link|description]] Images {{image.jpg}}, {{right:image.jpg}} (right aligned), [[link|{{image.jpg}}]] (image linked to link), {{image.jpg|alt text}} Extras ---- (horizonal rule), ~~~~ (signature)