Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

A plugin is a separate package with additional functionality for CONTENIDO which mostly is added to the backend.

Since CONTENIDO 4.9 plugins are installed via the Plugin manager.

Beside plugins from the community (so called third party plugins) CONTENIDO itself is released with various default plugins, which can be activated without downloading them.

Structure of a plugin

Plugins must follow a given structure so they can be installed correctly. Once at all, all files of a plugin package are packed to an ZIP archive, which later is unpacked from the installation routine of the plugin manager.

The content of this ZIP file must fit to the following guidelines.

ZIP archive filename

The name of the ZIP archive file must only contain the plugin name, for example: linkchecker.zip

plugin.xml

Each plugin must have a XML file which contains metadata for the plugin itself and for the installation in the system. Among other things this file is responsible for the folder name in the plugins directory of CONTENIDO. Most important it contains all relevant entries for some special database tables, so the plugin is accessible in the backend (creating menu entries and so on). These tables are: actions, area, files, frame_files and nav_sub.

The XML is divided into three parts - each separated to a XML tag. XML files must be valid against the plugin file schema located at xml/plugin_info.xsd located in the plugin managers plugin directory.

 

Universal Unique Identifier (UUID)

Each plugin must have an UUID to identify it globally. These IDs base on the values for the plugin_name and copyright fields in this file. UUIDs only can be generated on the CONTENIDO website. CURRENTLY UUID GENERATOR IS NOT ONLINE YET!

Tag general - meta information (required)

This tag contains meta information about the plugin which also are displayed in frontend. The tag has the attribute "active" which should have the value "1".

Tag nameDescriptionRequired?
plugin_nameFull plugin name.yes
plugin_foldernameName of the plugin folder.yes
uuidThe universal Unique ID.yes
descriptionDescription of the plugins functions.no
authorAuthoryes
copyrightCopyright noticeyes
mailMail address for supportno
websiteWebsite address for supportno
versionVersion of the pluginyes
min_contenido_versionFirst compatible version of CONTENIDOyes
max_contenido_versionLast compatible version of CONTENIDOno

Tag contenido - database specific information

This tag contains meta information about the plugin which also are displayed in frontend.

Currently under construction

This part of the page is currently under construction and soon contains all relevant information. Please be patient.

Tag content_types - registration of own content types

 This tag contains meta information about the plugin which also are displayed in frontend.

Currently under construction

This part of the page is currently under construction and soon contains all relevant information. Please be patient.

plugin-install.sql

This file contains additional statements executed on the installation of the plugin. 

Currently under construction

This part of the page is currently under construction and soon contains all relevant information. Please be patient.

plugin-uninstall.sql

This file contains additional statement executed on the uninstallation of the plugin.

Currently under construction

This part of the page is currently under construction and soon contains all relevant information. Please be patient.

  • No labels