Difference between revisions of "Extensions"

From Owl
Jump to: navigation, search
(Deatils)
(Example)
Line 16: Line 16:
  
 
extension.name = "amb-reputation";
 
extension.name = "amb-reputation";
extension.prettyName = "Reputation Extension for AMB for Owl 1.0";
+
extension.prettyName = "AMB Reputation";
 +
extension.description = "Owl extension for the vBulletin reputation system used on anothermessageboard.com";
  
 
extension.owlversion.min = "1.0";
 
extension.owlversion.min = "1.0";

Revision as of 12:03, 13 June 2014

Note
Upcoming Release
Some or all of the features mentioned in this article may not be present in the current public release of Owl.

Overview

Extensions allow developers to add functionality to Owl. Extensions can be created to use the core functionality of Owl using the Lua scripting language. Extensions are not the same Parsers. Parsers allow Owl to communicate with additional websites, extensions give extra functionality to Owl.

Example

The following example defines an extension that allows users to use vBulletin's repuation system on anothermessageboard.com.

<source lang="lua">-- This Owl Extension provides functionality that allows users to use the reputation system -- on AMB (www.anothermessageboard.com). Since AMB's reputation system is heavily modified, -- the generic vBulletin Reputation Extension (3.x) will not work, so a custom extension -- is required

extension.name = "amb-reputation"; extension.prettyName = "AMB Reputation"; extension.description = "Owl extension for the vBulletin reputation system used on anothermessageboard.com";

extension.owlversion.min = "1.0"; extension.domains = "*.anothermessageboard.com,*amb.la"; extension.boardware = "vbulletin/[3.6,4.0)/"; extension.owlware = "owl/1.*";</source>

Details

Owl requires basic information from all extensions in order to function properly. In the above examples the following settings are defined:

extension.name (required)
A normalized unique identifier for the extension.
extensions.prettyName (optional)
The name displayed within Owl's UI for a 'prettier' description of the extension.
extension.owlversion.min (optional)
The minimum version of Owl required to run the extension.
extension.owlversion.max (optional)
The maximum version of Owl that can run this extension.