awesome-zsh-plugins/Writing_Plugins.md

14 lines
1.5 KiB
Markdown
Raw Normal View History

2014-12-26 11:39:41 -08:00
# Writing Plugins
Try and keep your plugins as cross-framework compatible as possible. Here are some suggestions to make using your plugin as simple as possible, no matter what framework someone is using.
2015-01-13 07:42:57 -08:00
1. Make using it easier for everyone and put the plugin file at the root level of your plugin repository instead of in a subdirectory. This will let [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh) users install it with a simple `git clone git@github.com:you/yourplugin.git` in the `custom/plugins` directory. [Antigen](https://github.com/zsh-users/antigen) and [zgen](https://github.com/tarjoilija/zgen) users will be able to automatically clone the repository without having to specify subdirectories.
2014-12-26 11:39:41 -08:00
2. Only oh-my-zsh sets the `${ZSH_CUSTOM}` variable. `$(dirname $0)` will also tell you what directory your plugin is installed in, has the advantage of being cross-framework and won't break if the user renames your plugin directory.
2014-12-27 08:28:08 -08:00
3. Don't assume your plugin will be checked out into a directory with the same name you gave the plugin. This is another case where `$(dirname ${0})` will work and `${ZSH_CUSTOM}/hardcoded-directory` will fail.
2014-12-26 11:39:41 -08:00
2015-01-13 07:42:57 -08:00
4. Use `yourplugin.plugin.zsh` for the main plugin file. This is what [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh) expects. [Antigen](https://github.com/zsh-users/antigen), [zgen](https://github.com/tarjoilija/zgen) and most other ZSH frameworks support that filename.
2014-12-27 08:28:08 -08:00
5. Submit a PR here so your plugin is easy to find :-)