Difference between revisions of "Plugins"

Revision as of 16:46, 1 August 2004

Geeklog plugins are addon components that provide new functionality and leverage the internal services of Geeklog. Many of the available and contributed plugins are listed in this document. Plugins are different then blocks which normally do not use any of the internal Geeklog services (API's).

There are many services that a plugin can use to provide a tightly coupled application that now performs and looks like it a natural part of the over all Geeklog solution. It's possible to just wrap Geeklog around another application but it may have it's own security and user model for example. It's far better to have a single user database and security model to manage users and access to site features.

Plugins will for example automatically add themselves to your site navigation and provide the ability to restrict and control access to the component for public access and administrative functions.

Geeklog Plugins have access to the following services or API's

• Plugin Editor to install/de-install and enable/disable plugins
• Provide links to the SiteHeader Navigation, User and Admin Menu's
• Add to the site search function
• Extend the site stats reporting
• Leverate the GL Comment Engine
• Automatically update tables upon user add/edit/delete
• Extend the User Account Profile - add new options
• Support moderation to have admin approve content changes
• Provide new RSS Newsfeeds
• Provide a formatted Centerblock
• Integrate into the WhatsNew block

Plugins can be complete applications or provide a new administrative service but they all need to support a minimum set of features to be called a plugin.

• Support the Plugin Editor Install/De-install
• Provide new security rights such as plugin_name.edit and plugin_name.user
• Provide menu integration

Plugins all have a similar installation proceedure which requires a few manual steps to copy the plugun related files to the required directories. This part of the plugin installation is often confusing for new users/site admins. This is understandable but once you do one plugin, you will find others much easier to install.

In addition, each plugin may have other steps that need to be performed so read the plugin installation directions carefully.

As an overview to assist you with installing a plugin, I have created an illustrated image that describes the directory structure and locations of the plugin related folders and files.