closing merged branch
15 months ago, Gary Kramlich
closing merged branch
* Hello World Plugin
* Copyright (C) 2004, Gary Kramlich <>,
* 2007, John Bailey <>
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version.
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02111-1301, USA.
/* When writing a third-party plugin, do not include libpurple's internal.h
* included below. This file is for internal libpurple use only. We're including
* it here for our own convenience. */
#include "internal.h"
/* This file includes all the libpurple headers */
#include <purple.h>
/* This function is the callback for the plugin action we added. All we're
* doing here is displaying a message. When the user selects the plugin
* action, this function is called. */
static void
plugin_action_test_cb (PurplePluginAction * action)
purple_notify_message (action->plugin, PURPLE_NOTIFY_MSG_INFO,
"Plugin Actions Test", "This is a plugin actions test :)", NULL, NULL,
/* we tell libpurple in the PurplePluginInfo struct to call this function to
* get a list of plugin actions to use for the plugin. This function gives
* libpurple that list of actions. */
static GList *
plugin_actions (PurplePlugin * plugin)
/* some C89 (a.k.a. ANSI C) compilers will warn if any variable declaration
* includes an initilization that calls a function. To avoid that, we
* generally initialize our variables first with constant values like NULL
* or 0 and assign to them with function calls later */
GList *list = NULL;
PurplePluginAction *action = NULL;
/* The action gets created by specifying a name to show in the UI and a
* callback function to call. */
action = purple_plugin_action_new ("Plugin Action Test", plugin_action_test_cb);
/* libpurple requires a GList of plugin actions, even if there is only one
* action in the list. We append the action to a GList here. */
list = g_list_append (list, action);
/* Once the list is complete, we send it to libpurple. */
return list;
static PurplePluginInfo *
plugin_query (GError ** error)
const gchar * const authors[] = {
"John Bailey <>", /* correct author */
/* For specific notes on the meanings of each of these members, consult the
C Plugin Howto on the website. */
return purple_plugin_info_new (
"id", "core-hello_world",
"name", "Hello World!",
"version", DISPLAY_VERSION, /* This constant is defined in config.h, but you shouldn't use it for your
own plugins. We use it here because it's our plugin. And we're lazy. */
"category", "Example",
"summary", "Hello World Plugin",
"description", "Hello World Plugin",
"authors", authors,
"website", "http://helloworld.tld",
"abi-version", PURPLE_ABI_VERSION,
"actions-cb", plugin_actions, /* this tells libpurple the address of the function to call to get the list
of plugin actions. */
static gboolean
plugin_load (PurplePlugin * plugin, GError ** error)
purple_notify_message (plugin, PURPLE_NOTIFY_MSG_INFO, "Hello World!",
"This is the Hello World! plugin :)", NULL, NULL,
return TRUE;
static gboolean
plugin_unload (PurplePlugin * plugin, GError ** error)
return TRUE;
PURPLE_PLUGIN_INIT (hello_world, plugin_query, plugin_load, plugin_unload);