To implement plugins, you need to implement a single hook in your module to tell the system where your plugins live, and then you need to implement one or more .inc files that contain the plugin data.

## Telling it where your plugins live

To implement any plugins at all, you must implement a single function for all plugins: hook_ctools_plugin_directory. Every time a module loads plugins, this hook will be called to see which modules implement those plugins and in what directory those plugins will live.

    function hook_ctools_plugin_directory($module, $plugin) {
      if ($module == 'panels' && $plugin == 'content_types') {
        return 'plugins/content_types';
      }
    }

The directory returned should be relative to your module. Another common usage is to simply return that you implement all plugins owned by a given module (or modules):

    function hook_ctools_plugin_directory($module, $plugin) {
      if ($module == 'panels') {
        return 'plugins/' . $plugin;
      }
    }

Typically, it is recommended that all plugins be placed into the 'plugins' directory for clarity and maintainability. Inside the directory, any number of subdirectories can be used. For plugins that require extra files, such as templates, css, javascript or image files, this is highly recommended:

    mymodule.module
    mymodule.info
    plugins/
        content_types/
            my_content_type.inc
        layouts/
            my_layout.inc
            my_laout.css
            my_layout.tpl.php
            my_layout_image.png

## How a theme can implement plugins

Themes can implement plugins if the plugin owner specified that it's possible in its hook_ctools_api_TYPE() call. If so, it is generally exactly the same as modules, except for one important difference: themes don't get hook_ctools_plugin_directory(). Instead, themes add a line to their info file:

    plugins[module][type] = directory

## How to structure the .inc file

The top of the .inc file should contain an array that defines the plugin. This array is simply defined in the global namespace of the file and does not need a function. Note that previous versions of this plugin system required a specially named function. While this function will still work, its use is now discouraged, as it is annoying to name properly.

This array should look something like this:

    $plugin = array(
      'key' => 'value',
    );

Several values will be filled in for you automatically, but you can override them if necessary. They include 'name', 'path', 'file' and 'module'. Additionally, the plugin can owner can provide other defaults as well.

There are no required keys by the plugin system itself. The only requirements in the $plugin array will be defined by the plugin type.

After this array, if your plugin needs functions, they can be declared. Different plugin types have different needs here, so exactly what else will be needed will change from type to type.