= The Purple Plugin Pack = [[TOC()]] == About the Plugin Pack == The Purple Plugin Pack was originally created by [[Developer(grim)]] and [[Developer(nosnilmot)]] as a way to distribute their ever growing lists of simple Pidgin plugins. It has since grown from its origins of about 6 plugins to nearly 50. Also, many more developers have continued to add to it, including [[Developer(rekkanoryo)]], [[Developer(bleeter)]], [[Developer(sadrul)]], and most recently [[Developer(rlaager)]]. == Plugins in the Plugin Pack == 1. [wiki:album Album] 1. [wiki:autoaccept Auto Accept] [[FootNote(This plugin is now included in Pidgin's releases.)]] 1. Auto-rejoin (this was merged with IRC More in release 2.2.0) 1. [wiki:autoreply Auto Reply] 1. awaynotify [[FootNote(This plugin is not yet functional.)]] [[FootNote(This plugin has not yet been given a wiki page.)]] 1. [wiki:bash Bash.org] 1. [wiki:bit Buddy Icon Tools] 1. [wiki:blistops Buddy List Options] 1. [wiki:buddynote Buddy Note] [[FootNote(1)]] 1. buddytime [[FootNote(2)]] [[FootNote(3)]] 1. chronic [[FootNote(2)]] [[FootNote(3)]] 1. [wiki:convbadger Conversation Badger] 1. convcolors [[FootNote(1)]] [[FootNote(3)]] 1. DeWYSIWYGification [[FootNote(3)]] 1. [wiki:dice Dice] 1. [wiki:difftopic DiffTopic] 1. [wiki:eight_ball Magic 8 Ball] 1. [wiki:enhancedhist Enhanced History] 1. [wiki:flip Flip] 1. [wiki:gRIM gRIM] 1. [wiki:groupmsg Group Message] 1. [wiki:hideconv Hide Conversation] - ''This plugin no longer builds by default; we feel its functionality is superseded by Pidgin's persistent conversation support.'' 1. [wiki:highlight Highlight] 1. [wiki:ignore Ignore] 1. [wiki:irchelper IRC Helper] 1. [wiki:irc-more IRC More] 1. [wiki:irssi Irssi Features] 1. [wiki:lastseen Last Seen] 1. [wiki:listhandler List Handler] 1. [wiki:markerline Marker Line] [[FootNote(1)]] 1. [wiki:mystatusbox My Status Box] 1. [wiki:napster Napster Protocol] 1. [wiki:newline New Line] [[FootNote(1)]] 1. [wiki:nicksaid Nick Said] 1. [wiki:offlinemsg Offline Message] [[FootNote(1)]] 1. [wiki:oldlogger Old Logger] 1. [wiki:plonkers Plonkers] 1. [wiki:Schedule Schedule] [[FootNote(2)]] 1. [wiki:sepandtab Separate and Tab] 1. [wiki:showoffline Show Offline] 1. [wiki:simfix Sim Fix] 1. [wiki:slashexec Slash Exec] 1. [wiki:snpp Simple Network Paging Protocol (SNPP)] 1. [wiki:sslinfo SSL Info] 1. [wiki:stocker Stocker] [[FootNote(2)]] 1. [wiki:switchspell Switch Spell] 1. [wiki:timelog Timelog] 1. [wiki:talkfilters Talk Filters] 1. [wiki:gxr XMMS Remote] 1. [wiki:XChatChats XChat-Chats] [[FootNote]] == Plugin Pack Version Numbering == With the release of Purple Plugin Pack 2.0.0, we have changed our version numbering scheme. The new scheme works like this: * The format is major.minor.micro. * The major number follows libpurple's major number. This is intended to indicate the specific version of libpurple we support with that release. * The minor version reflects the state of the plugins list within the Plugin Pack. If we add or remove plugins, we will increment this number. Under certain circumstances determined by a quorum of our developers, massive rewrites that fundamentally change a given plugin such that the result could effectively be called removing one plugin and adding another will also cause a minor version increment. The minor version will increment by exactly one for each release in which these happen, even if multiple plugins are added/changed/rewritten. * The micro version increments for any other changes. This includes bugfix only releases or releases in which our build system changes. == Plugin Pack FAQ == === What is the Plugin Pack? === Please read the top of this page. === What dependencies does the Plugin Pack have? === The Plugin Pack has several dependencies. Obviously, libpurple is a required dependency. These plugins cannot build or function without libpurple. Some plugins require Pidgin. Since Pidgin requires both GTK+ and GLib, these plugins indirectly require them. Several of the plugins also require GTK+ directly, and all require glib directly. Since we support internationalization/localization/translations, GNU gettext is also a required dependency. The talkfilters plugin requires GNU Talk Filters in order to function, therefore it is a dependency; however, it is optional. If GNU Talk Filters is not detected during configuration, the configure script will disable the talkfilters plugin automatically. The xmmsremote plugin requires XMMS 1.x. If this is not detected during configuration, the configure script will disable the xmmsremote plugin. Other dependencies may eventually be introduced as the Plugin Pack continues to grow. === Why don't I have (plugin)? === We primarily target the newest release of Pidgin, whether or not it is a beta release. Therefore we by default disable plugins that are incompatible with the newest Pidgin release. Some plugins may also represent what we feel to be too great an abuse potential, and therefore we disable them by default in an attempt to reduce such abuse. We define abuse potential as the ability to use a plugin to engage in spimming activities, which we take an extremely dim view upon. Also, an author may have forgotten to enable the building of a plugin by default. It is possible to build and install any missing plugins yourself, particularly if you built from source to begin with. If some functionality has been made part of Pidgin or Finch that supersedes a plugin, we may continue to maintain the plugin but prevent it from building by default to prevent confusion between features of the plugin and features of the application. === How do I enable a plugin you have not enabled by default? === There are a few ways if you're NOT on Windows. We will cover Windows in a separate question, as it is a different process. You can `touch plugindir/.build` from the top level source directory and then run the configure script again; this is the easiest way. The second way is to do a for loop in your shell, similar to this for bash: `for i in *; do cd $i && make && su -c 'make install' && cd ..; done`. The third way is to run the configure script with the argument `--with-plugins=plugin1,plugin2,...,pluginN` where you specify a comma delimited list of the plugins you want to build. After running the configure script in either way mentioned here, build and install as normal. === How do I disable a plugin you have enabled by default? === There are again three ways to do this. The simplest is to be in the top level source directory and do `rm plugindir/.build`. The next way is a for loop in the shell to build only the plugins you want, but we will leave that as an exercise for you to figure out the syntax of. The third way is to run the configure script with the argument `--with-plugins=plugin1,plugin2,...,pluginN` where you specify a comma delimited list of the plugins you want to build. After running the configure script in either way mentioned here, build and install as normal. === What do you mean by "build and install as normal"? === As with any source package you install yourself, you will first use a configure script included with the source distribution to configure the package for compilation and installation. After the configure script completes, you need to run `make` to build it, and then possibly `su -c 'make install'` to install the compiled package. The `su -c` may not be necessary if you are installing to a location that your user account has write access to, or if you can use sudo instead. === How do I build on Windows? How do I build plugins that aren't enabled by default on Windows? === Follow the [http://developer.pidgin.im/wiki/BuildingWinPidgin Windows Pidgin Build Instructions] and get a working !WinPidgin Build environment up and running. Build Pidgin. You do ''not'' have to build the installer for Pidgin. Download the Plugin Pack source distribution and extract it to `pidgin-PIDGINVERSION/pidgin/plugins` with `tar -zxvf /path/to/plugin_pack-PPPVERSION.tar.gz` while you are in `pidgin-PIDGINVERSION/pidgin/plugins`. Change into the Plugin Pack source directory and run `make -f Makefile.mingw` to compile the plugins. You can also do `make -f Makefile.mingw install` to copy the plugins to the win32-install-dir created during the Pidgin make process. From there you can copy the .dll files for our plugins to the Pidgin plugins directory. For plugins that aren't built by default, change into the plugin's directory and `make -f Makefile.mingw` to build the plugin (note that the talkfilters and xmmsremote plugins don't work on Windows), then copy the .dll to the Pidgin plugins directory. === Will you accept my plugin for the Purple Plugin Pack? === The short answer is "Maybe." The long answer is still "Maybe," but with this more detailed answer. Currently the plugins that have been added to the Plugin Pack have been added by their authors, who were already developers on the Guifications project. However, since our move from SourceForge and the evolution of Guifications beyond a Pidgin plugin (thus causing Guifications and the Pidgin Plugins to diverge into two separate but somewhat overlapping projects), we have begun to extend offers to some plugin authors whose plugins we feel would make a positive addition to the Plugin Pack. There are numerous factors that we are considering in extending these invitations, and most, if not all, of these factors will apply in a decision on plugins whose authors approach us about inclusion in the Plugin Pack. === How do I install the Windows version? It's just a zip file! === Locate your .purple directory. This is usually in `%APPDATA%\.purple`. If you need to, create the plugins folder there. Drop the DLL's in this plugins folder. You could also put them in the plugins directory in the Pidgin installation directory, but Pidgin's installer will delete the plugins when you upgrade Pidgin; thus the .purple directory is a safer location to preserve your plugins across Pidgin updates. === Where is the documentation for the Plugin Pack? What about the plugins? === You're looking at it. Above is a list of the plugins with links to their wiki pages. If the documentation is insufficient, you can improve it. If you don't already have an account, register for one, log in, and then edit the pages needing improvements. If you do edit the pages, please try to follow the same conventions we use so that the wiki has a consistent feel to it. === What version of Pidgin does the Purple Plugin Pack work with? === The Windows zip file will generally be compiled for the newest Pidgin version available at release time. Most of the plugins will build against Pidgin 2.0.0, however. If you have trouble building against Pidgin releases older than the most recent but equal to or newer than Pidgin 2.0.0, let us know by opening a ticket. ---- == Ticket System == === Open Plugin Pack Bugs === [[TicketQuery(status=new|assigned|reopened&order=ticket&type=Bugs&component=PluginPack|PluginPackWin32)]] === Open PluginPack Feature Requests === [[TicketQuery(status=new|assigned|reopened&order=ticket&type=FeatureRequest&component=PluginPack|PluginPackWin32)]] === Open PluginPack Patches === [[TicketQuery(status=new|assigned|reopened&order=ticket&type=Patches&component=PluginPack|PluginPackWin32)]] [[BackLinks]]