diff --git a/CHANGELOG b/CHANGELOG index e9b5cae857..9ad9137714 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -299,7 +299,7 @@ Version 3.4.3 (2015-12-22) Contact's posts are shown in a dedicated page (annando) Module name is shown in page title to ease browser history navigation (issue #2079) (tobiasd) What's new for admins: - Forumlist functionality moved from plugin to core (rabuzarus, annando) + Forumlist functionality moved from addon to core (rabuzarus, annando) Changes on poller/workers limits management (annando) Diaspora and OStatus can be enabled only if requirements are satisfied (annando) Support for additional passwords for ejabberd (annando) @@ -380,7 +380,7 @@ Version 3.4.2 (2015-09-29) Support for inline [code] tag usage (fabrixxm) Fix login form in aside (issue #1348) (annando) Show both url-style and webfinger-style identity address in profile (issue #1621) (tobiasd) - Add button to reload all active plugins in admin plugins page to ensure new hooks are used (fabrixxm) + Add button to reload all active addons in admin addons page to ensure new hooks are used (fabrixxm) Make the hardcoded path to global directory configurable (annando) Change default directory to dir.friendi.ca (annando) Improve cache system with granular expire time (annando) diff --git a/INSTALL.txt b/INSTALL.txt index eaf7604e3e..01fe65d118 100644 --- a/INSTALL.txt +++ b/INSTALL.txt @@ -130,18 +130,18 @@ You should also be sure that $a->config['php_path'] is set correctly, it should look like (changing it to the correct PHP location) $a->config['php_path'] = '/usr/local/php53/bin/php' - -Alternative: You may be able to use the 'poormancron' plugin to perform this + +Alternative: You may be able to use the 'poormancron' addon to perform this step if you are using a recent Friendica release. 'poormancron' may result in perfomance and memory issues and is only suitable for small sites with one or -two users and a handful of contacts. To do this, edit the file -".htconfig.php" and look for a line describing your plugins. On a fresh +two users and a handful of contacts. To do this, edit the file +".htconfig.php" and look for a line describing your addons. On a fresh installation, it will look like $a->config['system']['addon'] = 'js_upload'; -This indicates the "js_upload" addon module is enabled. You may add additional -addons/plugins using this same line in the configuration file. Change it to +This indicates the "js_upload" addon module is enabled. You may add additional +addons using this same line in the configuration file. Change it to read $a->config['system']['addon'] = 'js_upload,poormancron'; diff --git a/README.md b/README.md index 4e627ef2d3..20d6b0ef50 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ Our mission is to free friends, family and colleagues from data-harvesting corpo Friendica connects you effortlessly to a federated communications network of several thousand servers, with more than half a million user registrations. You can directly connect to anyone on [Friendica]( https://friendi.ca), [Mastodon](https://joinmastodon.org/), [Diaspora](https://diasporafoundation.org/), [GnuSocial](https://gnu.io/social/), [Pleroma](https://pleroma.social/), or [Hubzilla](https://hubzilla.org/), regardless where each user profile is hosted. -With Friendica, you can also fully interact with anyone on Twitter, post on Facebook and receive any content on Tumblr, Wordpress or RSS. Friendica allows you to integrate most things on the web via a range of plugins such as ITTT, Buffer; you will be able to easily control your own data as you decide. +With Friendica, you can also fully interact with anyone on Twitter, post on Facebook and receive any content on Tumblr, Wordpress or RSS. Friendica allows you to integrate most things on the web via a range of addons such as ITTT, Buffer; you will be able to easily control your own data as you decide. Join today and [get your Friendica profile!](https://dir.friendica.social/servers 'Join Friendica today!') diff --git a/boot.php b/boot.php index 0692e84757..776cf49fa8 100644 --- a/boot.php +++ b/boot.php @@ -21,6 +21,7 @@ require_once __DIR__ . DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR . 'autoload.php'; use Friendica\App; +use Friendica\Core\Addon; use Friendica\Core\System; use Friendica\Core\Cache; use Friendica\Core\Config; @@ -32,7 +33,6 @@ use Friendica\Database\DBStructure; use Friendica\Module\Login; require_once 'include/network.php'; -require_once 'include/plugin.php'; require_once 'include/text.php'; require_once 'include/datetime.php'; require_once 'include/pgettext.php'; @@ -798,19 +798,19 @@ function run_update_function($x) } /** - * @brief Synchronise plugins: + * @brief Synchronise addons: * * $a->config['system']['addon'] contains a comma-separated list of names - * of plugins/addons which are used on this system. + * of addons which are used on this system. * Go through the database list of already installed addons, and if we have * an entry, but it isn't in the config list, call the uninstall procedure * and mark it uninstalled in the database (for now we'll remove it). - * Then go through the config list and if we have a plugin that isn't installed, + * Then go through the config list and if we have a addon that isn't installed, * call the install procedure and add it to the database. * * @param object $a App */ -function check_plugins(App $a) +function check_addons(App $a) { $r = q("SELECT * FROM `addon` WHERE `installed` = 1"); if (DBM::is_result($r)) { @@ -819,36 +819,36 @@ function check_plugins(App $a) $installed = []; } - $plugins = Config::get('system', 'addon'); - $plugins_arr = []; + $addons = Config::get('system', 'addon'); + $addons_arr = []; - if ($plugins) { - $plugins_arr = explode(',', str_replace(' ', '', $plugins)); + if ($addons) { + $addons_arr = explode(',', str_replace(' ', '', $addons)); } - $a->plugins = $plugins_arr; + $a->addons = $addons_arr; $installed_arr = []; if (count($installed)) { foreach ($installed as $i) { - if (!in_array($i['name'], $plugins_arr)) { - uninstall_plugin($i['name']); + if (!in_array($i['name'], $addons_arr)) { + Addon::uninstall($i['name']); } else { $installed_arr[] = $i['name']; } } } - if (count($plugins_arr)) { - foreach ($plugins_arr as $p) { + if (count($addons_arr)) { + foreach ($addons_arr as $p) { if (!in_array($p, $installed_arr)) { - install_plugin($p); + Addon::install($p); } } } - load_hooks(); + Addon::loadHooks(); return; } diff --git a/doc/Accesskeys.md b/doc/Accesskeys.md index 3369f9afd9..b9e5f5430a 100644 --- a/doc/Accesskeys.md +++ b/doc/Accesskeys.md @@ -69,7 +69,7 @@ General * o: Account * t: Additional features * w: Social Networks -* l: Plugins +* l: Addons * d: Delegations * b: Connected apps * e: Export personal data diff --git a/doc/Plugins.md b/doc/Addons.md similarity index 54% rename from doc/Plugins.md rename to doc/Addons.md index ab8c58eb85..5d13107769 100644 --- a/doc/Plugins.md +++ b/doc/Addons.md @@ -1,4 +1,4 @@ -Friendica Addon/Plugin development +Friendica Addon development ============== * [Home](help) @@ -7,32 +7,32 @@ Please see the sample addon 'randplace' for a working example of using some of t Addons work by intercepting event hooks - which must be registered. Modules work by intercepting specific page requests (by URL path). -Plugin names cannot contain spaces or other punctuation and are used as filenames and function names. +Addon names cannot contain spaces or other punctuation and are used as filenames and function names. You may supply a "friendly" name within the comment block. -Each addon must contain both an install and an uninstall function based on the addon/plugin name. -For instance "plugin1name_install()". -These two functions take no arguments and are usually responsible for registering (and unregistering) event hooks that your plugin will require. -The install and uninstall functions will also be called (i.e. re-installed) if the plugin changes after installation. +Each addon must contain both an install and an uninstall function based on the addon name. +For instance "addon1name_install()". +These two functions take no arguments and are usually responsible for registering (and unregistering) event hooks that your addon will require. +The install and uninstall functions will also be called (i.e. re-installed) if the addon changes after installation. Therefore your uninstall should not destroy data and install should consider that data may already exist. Future extensions may provide for "setup" amd "remove". -Plugins should contain a comment block with the four following parameters: +Addons should contain a comment block with the four following parameters: /* - * Name: My Great Plugin - * Description: This is what my plugin does. It's really cool. + * Name: My Great Addon + * Description: This is what my addon does. It's really cool. * Version: 1.0 * Author: John Q. Public */ -Register your plugin hooks during installation. +Register your addon hooks during installation. - register_hook($hookname, $file, $function); + Addon::registerHook($hookname, $file, $function); $hookname is a string and corresponds to a known Friendica hook. $file is a pathname relative to the top-level Friendica directory. -This *should* be 'addon/plugin_name/plugin_name.php' in most cases. +This *should* be 'addon/addon_name/addon_name.php' in most cases. $function is a string and is the name of the function which will be executed when the hook is called. @@ -69,39 +69,39 @@ Remember to declare it with '&' if you wish to alter it. Modules --- -Plugins/addons may also act as "modules" and intercept all page requests for a given URL path. -In order for a plugin to act as a module it needs to define a function "plugin_name_module()" which takes no arguments and needs not do anything. +Addons may also act as "modules" and intercept all page requests for a given URL path. +In order for a addon to act as a module it needs to define a function "addon_name_module()" which takes no arguments and needs not do anything. -If this function exists, you will now receive all page requests for "http://my.web.site/plugin_name" - with any number of URL components as additional arguments. +If this function exists, you will now receive all page requests for "http://my.web.site/addon_name" - with any number of URL components as additional arguments. These are parsed into an array $a->argv, with a corresponding $a->argc indicating the number of URL components. -So http://my.web.site/plugin/arg1/arg2 would look for a module named "plugin" and pass its module functions the $a App structure (which is available to many components). +So http://my.web.site/addon/arg1/arg2 would look for a module named "addon" and pass its module functions the $a App structure (which is available to many components). This will include: $a->argc = 3 - $a->argv = array(0 => 'plugin', 1 => 'arg1', 2 => 'arg2'); + $a->argv = array(0 => 'addon', 1 => 'arg1', 2 => 'arg2'); -Your module functions will often contain the function plugin_name_content(App $a), which defines and returns the page body content. -They may also contain plugin_name_post(App $a) which is called before the _content function and typically handles the results of POST forms. -You may also have plugin_name_init(App $a) which is called very early on and often does module initialisation. +Your module functions will often contain the function addon_name_content(App $a), which defines and returns the page body content. +They may also contain addon_name_post(App $a) which is called before the _content function and typically handles the results of POST forms. +You may also have addon_name_init(App $a) which is called very early on and often does module initialisation. Templates --- -If your plugin needs some template, you can use the Friendica template system. +If your addon needs some template, you can use the Friendica template system. Friendica uses [smarty3](http://www.smarty.net/) as a template engine. -Put your tpl files in the *templates/* subfolder of your plugin. +Put your tpl files in the *templates/* subfolder of your addon. -In your code, like in the function plugin_name_content(), load the template file and execute it passing needed values: +In your code, like in the function addon_name_content(), load the template file and execute it passing needed values: # load template file. first argument is the template name, - # second is the plugin path relative to friendica top folder - $tpl = get_markup_template('mytemplate.tpl', 'addon/plugin_name/'); + # second is the addon path relative to friendica top folder + $tpl = get_markup_template('mytemplate.tpl', 'addon/addon_name/'); # apply template. first argument is the loaded template, # second an array of 'name'=>'values' to pass to template $output = replace_macros($tpl,array( - 'title' => 'My beautiful plugin', + 'title' => 'My beautiful addon', )); See also the wiki page [Quick Template Guide](https://github.com/friendica/friendica/wiki/Quick-Template-Guide). @@ -151,11 +151,11 @@ $b is an array: * called when the Settings pages are submitted * $b is the $_POST array -### 'plugin_settings' +### 'addon_settings' * called when generating the HTML for the addon settings page * $b is the (string) HTML of the addon settings page before the final '' tag. -### 'plugin_settings_post' +### 'addon_settings_post' * called when the Addon Settings pages are submitted * $b is the $_POST array @@ -296,182 +296,178 @@ Complete list of hook callbacks Here is a complete list of all hook callbacks with file locations (as of 14-Feb-2012). Please see the source for details of any hooks not documented above. -boot.php: call_hooks('login_hook',$o); +boot.php: Addon::callHooks('login_hook',$o); -boot.php: call_hooks('profile_sidebar_enter', $profile); +boot.php: Addon::callHooks('profile_sidebar_enter', $profile); -boot.php: call_hooks('profile_sidebar', $arr); +boot.php: Addon::callHooks('profile_sidebar', $arr); -boot.php: call_hooks("proc_run", $arr); +boot.php: Addon::callHooks("proc_run", $arr); -include/contact_selectors.php: call_hooks('network_to_name', $nets); +include/contact_selectors.php: Addon::callHooks('network_to_name', $nets); -include/api.php: call_hooks('logged_in', $a->user); +include/api.php: Addon::callHooks('logged_in', $a->user); -include/api.php: call_hooks('logged_in', $a->user); +include/api.php: Addon::callHooks('logged_in', $a->user); -include/queue.php: call_hooks('queue_predeliver', $a, $r); +include/queue.php: Addon::callHooks('queue_predeliver', $a, $r); -include/queue.php: call_hooks('queue_deliver', $a, $params); +include/queue.php: Addon::callHooks('queue_deliver', $a, $params); -include/text.php: call_hooks('contact_block_end', $arr); +include/text.php: Addon::callHooks('contact_block_end', $arr); -include/text.php: call_hooks('smilie', $s); +include/text.php: Addon::callHooks('smilie', $s); -include/text.php: call_hooks('prepare_body_init', $item); +include/text.php: Addon::callHooks('prepare_body_init', $item); -include/text.php: call_hooks('prepare_body', $prep_arr); +include/text.php: Addon::callHooks('prepare_body', $prep_arr); -include/text.php: call_hooks('prepare_body_final', $prep_arr); +include/text.php: Addon::callHooks('prepare_body_final', $prep_arr); -include/nav.php: call_hooks('page_header', $a->page['nav']); +include/nav.php: Addon::callHooks('page_header', $a->page['nav']); -include/auth.php: call_hooks('authenticate', $addon_auth); +include/auth.php: Addon::callHooks('authenticate', $addon_auth); -include/bbcode.php: call_hooks('bbcode',$Text); +include/bbcode.php: Addon::callHooks('bbcode',$Text); -include/oauth.php: call_hooks('logged_in', $a->user); +include/oauth.php: Addon::callHooks('logged_in', $a->user); -include/acl_selectors.php: call_hooks($a->module . '_pre_' . $selname, $arr); +include/acl_selectors.php: Addon::callHooks($a->module . '_pre_' . $selname, $arr); -include/acl_selectors.php: call_hooks($a->module . '_post_' . $selname, $o); +include/acl_selectors.php: Addon::callHooks($a->module . '_post_' . $selname, $o); -include/acl_selectors.php: call_hooks('contact_select_options', $x); +include/acl_selectors.php: Addon::callHooks('contact_select_options', $x); -include/acl_selectors.php: call_hooks($a->module . '_pre_' . $selname, $arr); +include/acl_selectors.php: Addon::callHooks($a->module . '_pre_' . $selname, $arr); -include/acl_selectors.php: call_hooks($a->module . '_post_' . $selname, $o); +include/acl_selectors.php: Addon::callHooks($a->module . '_post_' . $selname, $o); -include/acl_selectors.php: call_hooks($a->module . '_pre_' . $selname, $arr); +include/acl_selectors.php: Addon::callHooks($a->module . '_pre_' . $selname, $arr); -include/acl_selectors.php: call_hooks($a->module . '_post_' . $selname, $o); +include/acl_selectors.php: Addon::callHooks($a->module . '_post_' . $selname, $o); -include/acl_selectors.php call_hooks('acl_lookup_end', $results); +include/acl_selectors.php Addon::callHooks('acl_lookup_end', $results); -include/notifier.php: call_hooks('notifier_normal',$target_item); +include/notifier.php: Addon::callHooks('notifier_normal',$target_item); -include/notifier.php: call_hooks('notifier_end',$target_item); +include/notifier.php: Addon::callHooks('notifier_end',$target_item); -include/items.php: call_hooks('atom_feed', $atom); +include/items.php: Addon::callHooks('atom_feed', $atom); -include/items.php: call_hooks('atom_feed_end', $atom); +include/items.php: Addon::callHooks('atom_feed_end', $atom); -include/items.php: call_hooks('atom_feed_end', $atom); +include/items.php: Addon::callHooks('atom_feed_end', $atom); -include/items.php: call_hooks('parse_atom', $arr); +include/items.php: Addon::callHooks('parse_atom', $arr); -include/items.php: call_hooks('post_remote',$arr); +include/items.php: Addon::callHooks('post_remote',$arr); -include/items.php: call_hooks('atom_author', $o); +include/items.php: Addon::callHooks('atom_author', $o); -include/items.php: call_hooks('atom_entry', $o); +include/items.php: Addon::callHooks('atom_entry', $o); -include/bb2diaspora.php: call_hooks('bb2diaspora',$Text); +include/bb2diaspora.php: Addon::callHooks('bb2diaspora',$Text); -include/cronhooks.php: call_hooks('cron', $d); +include/cronhooks.php: Addon::callHooks('cron', $d); -include/security.php: call_hooks('logged_in', $a->user); +include/security.php: Addon::callHooks('logged_in', $a->user); -include/html2bbcode.php: call_hooks('html2bbcode', $text); +include/html2bbcode.php: Addon::callHooks('html2bbcode', $text); -include/Contact.php: call_hooks('remove_user',$r[0]); +include/Contact.php: Addon::callHooks('remove_user',$r[0]); -include/Contact.php: call_hooks('contact_photo_menu', $args); +include/Contact.php: Addon::callHooks('contact_photo_menu', $args); -include/conversation.php: call_hooks('conversation_start',$cb); +include/conversation.php: Addon::callHooks('conversation_start',$cb); -include/conversation.php: call_hooks('render_location',$locate); +include/conversation.php: Addon::callHooks('render_location',$locate); -include/conversation.php: call_hooks('display_item', $arr); +include/conversation.php: Addon::callHooks('display_item', $arr); -include/conversation.php: call_hooks('render_location',$locate); +include/conversation.php: Addon::callHooks('render_location',$locate); -include/conversation.php: call_hooks('display_item', $arr); +include/conversation.php: Addon::callHooks('display_item', $arr); -include/conversation.php: call_hooks('item_photo_menu', $args); +include/conversation.php: Addon::callHooks('item_photo_menu', $args); -include/conversation.php: call_hooks('jot_tool', $jotplugins); +include/conversation.php: Addon::callHooks('jot_tool', $jotplugins); -include/conversation.php: call_hooks('jot_networks', $jotnets); +include/conversation.php: Addon::callHooks('jot_networks', $jotnets); -include/plugin.php:if(! function_exists('call_hooks')) { +index.php: Addon::callHooks('init_1'); -include/plugin.php:function call_hooks($name, &$data = null) { +index.php:Addon::callHooks('app_menu', $arr); -index.php: call_hooks('init_1'); +index.php:Addon::callHooks('page_end', $a->page['content']); -index.php:call_hooks('app_menu', $arr); +mod/photos.php: Addon::callHooks('photo_post_init', $_POST); -index.php:call_hooks('page_end', $a->page['content']); +mod/photos.php: Addon::callHooks('photo_post_file',$ret); -mod/photos.php: call_hooks('photo_post_init', $_POST); +mod/photos.php: Addon::callHooks('photo_post_end',$foo); -mod/photos.php: call_hooks('photo_post_file',$ret); +mod/photos.php: Addon::callHooks('photo_post_end',$foo); -mod/photos.php: call_hooks('photo_post_end',$foo); +mod/photos.php: Addon::callHooks('photo_post_end',$foo); -mod/photos.php: call_hooks('photo_post_end',$foo); +mod/photos.php: Addon::callHooks('photo_post_end',intval($item_id)); -mod/photos.php: call_hooks('photo_post_end',$foo); +mod/photos.php: Addon::callHooks('photo_upload_form',$ret); -mod/photos.php: call_hooks('photo_post_end',intval($item_id)); +mod/friendica.php: Addon::callHooks('about_hook', $o); -mod/photos.php: call_hooks('photo_upload_form',$ret); +mod/editpost.php: Addon::callHooks('jot_tool', $jotplugins); -mod/friendica.php: call_hooks('about_hook', $o); +mod/editpost.php: Addon::callHooks('jot_networks', $jotnets); -mod/editpost.php: call_hooks('jot_tool', $jotplugins); +mod/parse_url.php: Addon::callHooks('parse_link', $arr); -mod/editpost.php: call_hooks('jot_networks', $jotnets); +mod/home.php: Addon::callHooks('home_init',$ret); -mod/parse_url.php: call_hooks('parse_link', $arr); +mod/home.php: Addon::callHooks("home_content",$o); -mod/home.php: call_hooks('home_init',$ret); +mod/contacts.php: Addon::callHooks('contact_edit_post', $_POST); -mod/home.php: call_hooks("home_content",$o); +mod/contacts.php: Addon::callHooks('contact_edit', $arr); -mod/contacts.php: call_hooks('contact_edit_post', $_POST); +mod/settings.php: Addon::callHooks('addon_settings_post', $_POST); -mod/contacts.php: call_hooks('contact_edit', $arr); +mod/settings.php: Addon::callHooks('connector_settings_post', $_POST); -mod/settings.php: call_hooks('plugin_settings_post', $_POST); +mod/settings.php: Addon::callHooks('settings_post', $_POST); -mod/settings.php: call_hooks('connector_settings_post', $_POST); +mod/settings.php: Addon::callHooks('addon_settings', $settings_addons); -mod/settings.php: call_hooks('settings_post', $_POST); +mod/settings.php: Addon::callHooks('connector_settings', $settings_connectors); -mod/settings.php: call_hooks('plugin_settings', $settings_addons); +mod/settings.php: Addon::callHooks('settings_form',$o); -mod/settings.php: call_hooks('connector_settings', $settings_connectors); +mod/register.php: Addon::callHooks('register_account', $newuid); -mod/settings.php: call_hooks('settings_form',$o); +mod/like.php: Addon::callHooks('post_local_end', $arr); -mod/register.php: call_hooks('register_account', $newuid); +mod/xrd.php: Addon::callHooks('personal_xrd', $arr); -mod/like.php: call_hooks('post_local_end', $arr); +mod/item.php: Addon::callHooks('post_local_start', $_REQUEST); -mod/xrd.php: call_hooks('personal_xrd', $arr); +mod/item.php: Addon::callHooks('post_local',$datarray); -mod/item.php: call_hooks('post_local_start', $_REQUEST); +mod/item.php: Addon::callHooks('post_local_end', $datarray); -mod/item.php: call_hooks('post_local',$datarray); +mod/profile.php: Addon::callHooks('profile_advanced',$o); -mod/item.php: call_hooks('post_local_end', $datarray); +mod/profiles.php: Addon::callHooks('profile_post', $_POST); -mod/profile.php: call_hooks('profile_advanced',$o); +mod/profiles.php: Addon::callHooks('profile_edit', $arr); -mod/profiles.php: call_hooks('profile_post', $_POST); +mod/tagger.php: Addon::callHooks('post_local_end', $arr); -mod/profiles.php: call_hooks('profile_edit', $arr); +mod/cb.php: Addon::callHooks('cb_init'); -mod/tagger.php: call_hooks('post_local_end', $arr); +mod/cb.php: Addon::callHooks('cb_post', $_POST); -mod/cb.php: call_hooks('cb_init'); +mod/cb.php: Addon::callHooks('cb_afterpost'); -mod/cb.php: call_hooks('cb_post', $_POST); +mod/cb.php: Addon::callHooks('cb_content', $o); -mod/cb.php: call_hooks('cb_afterpost'); - -mod/cb.php: call_hooks('cb_content', $o); - -mod/directory.php: call_hooks('directory_item', $arr); +mod/directory.php: Addon::callHooks('directory_item', $arr); diff --git a/doc/Chats.md b/doc/Chats.md index 4e392f8d8f..b7557944f3 100644 --- a/doc/Chats.md +++ b/doc/Chats.md @@ -8,10 +8,10 @@ There are two possibilities to use chat on your friendica site * IRC Chat * Jappix -IRC-Chat Plugin +IRC-Chat Addon --- -After activating the plugin, you can find the chat at [yoursite.com/irc](../irc). +After activating the addon, you can find the chat at [yoursite.com/irc](../irc). Note: you can use this chat without any login at your site so that everyone could use it. If you follow the link, you will see the login page of the IRC chat. @@ -28,8 +28,8 @@ The lower part of the window contains an input field. Jappix Mini --- -The Jappix Mini Plugin creates a chatbox for jabber- and XMPP-contacts. -You should already have a jabber/XMPP-account before setting up the plugin. +The Jappix Mini Addon creates a chatbox for jabber- and XMPP-contacts. +You should already have a jabber/XMPP-account before setting up the addon. You can find more information at [jabber.org](http://www.jabber.org/). You can use several servers to create an account: @@ -48,15 +48,15 @@ Or you can download a tar archive here: [jappixmini.tgz](https://github.com/frie Just unpack the file and rename the directory to „jappixmini“. Next, upload this directory and the .tgz-file into your addon directory of your friendica installation. -Now you can activate the plugin globally on the admin pages. -In the plugin sidebar, you will find an entry of jappix now (where you can also find twitter, GNU Social and others). -The following page shows the settings of this plugin. +Now you can activate the addon globally on the admin pages. +In the addon sidebar, you will find an entry of jappix now (where you can also find twitter, GNU Social and others). +The following page shows the settings of this addon. Activate the BOSH proxy. ###2. Settings -Go to your user account settings next and choose the plugin page. +Go to your user account settings next and choose the addon page. Scroll down until you find the Jappix Mini addon settings. At first you have to activate the addon. diff --git a/doc/Composer.md b/doc/Composer.md index 02ce61639c..41fc2aca37 100644 --- a/doc/Composer.md +++ b/doc/Composer.md @@ -55,7 +55,7 @@ If you don't need to use any third-party library, then you don't need to use Com #### Adding a third-party library to Friendica -Does your shiny new [Plugin](help/Plugins) need to rely on a third-party library not required by Friendica yet? +Does your shiny new [Addon](help/Addons) need to rely on a third-party library not required by Friendica yet? First of all, this library should be available on [Packagist](https://packagist.org) so that Composer knows how to fetch it directly just by mentioning its name in `composer.json`. This file is the configuration of Friendica for Composer. It lists details about the Friendica project, but also a list of required dependencies and their target version. diff --git a/doc/FAQ.md b/doc/FAQ.md index fddc64abc0..ccf81d8a94 100644 --- a/doc/FAQ.md +++ b/doc/FAQ.md @@ -87,7 +87,7 @@ Blocked contacts cannot do this. They cannot communicate with you directly, only However we do not import their posts or private messages to you. Like blocking, you will still see this person's comments to posts made by your friends. -A plugin called "blockem" can be installed to collapse/hide all posts from a particular person in your stream if you desire complete blocking of an individual, including his/her conversations with your other friends. +An addon called "blockem" can be installed to collapse/hide all posts from a particular person in your stream if you desire complete blocking of an individual, including his/her conversations with your other friends. An **archived contact** means that communication is not possible and will not be attempted. (Perhaps the person moved to a new site and removed the old profile.) diff --git a/doc/Home.md b/doc/Home.md index 4f956e3c7a..0a1059d019 100644 --- a/doc/Home.md +++ b/doc/Home.md @@ -43,7 +43,7 @@ Friendica Documentation and Resources * [Help on Vagrant](help/Vagrant) * [Bugs and Issues](help/Bugs-and-Issues) * Code structure - * [Plugin Development](help/Plugins) + * [Addon Development](help/Addons) * [Theme Development](help/themes) * [Smarty 3 Templates](help/smarty3-templates) * How To diff --git a/doc/Improve-Performance.md b/doc/Improve-Performance.md index 8c0529bd56..48ac9e798d 100644 --- a/doc/Improve-Performance.md +++ b/doc/Improve-Performance.md @@ -22,16 +22,16 @@ If you have many OStatus contacts then completing of conversations can take some When using MyISAM (default) or InnoDB on MariaDB 10 this speeds up search. -Plugins +Addons -------- -Active the following plugins: +Active the following addons: rendertime ###rendertime -This plugin doesn't speed up your system. +This addon doesn't speed up your system. It helps to analyze your bottlenecks. When enabled you see some values at the bottom of every page. diff --git a/doc/Installing-Connectors.md b/doc/Installing-Connectors.md index 34ade6b3be..1d83f07420 100644 --- a/doc/Installing-Connectors.md +++ b/doc/Installing-Connectors.md @@ -4,28 +4,28 @@ Installing Connectors (Twitter/GNU Social) * [Home](help) -Friendica uses plugins to provide connectivity to some networks, such as Twitter or App.net. +Friendica uses addons to provide connectivity to some networks, such as Twitter or App.net. -There is also a plugin to post through to an existing account on a GNU Social service. +There is also a addon to post through to an existing account on a GNU Social service. You only need this to post to an already existing GNU Social account, but not to communicate with GNU Social members in general. -All three plugins require an account on the target network. +All three addons require an account on the target network. In addition you (or typically the server administrator) will need to obtain an API key to provide authenticated access to your Friendica server. Site Configuration --- -Plugins must be installed by the site administrator before they can be used. +Addons must be installed by the site administrator before they can be used. This is accomplished through the site administration panel. Each of the connectors also requires an "API key" from the service you wish to connect with. -Some plugins allow you to enter this information in the site administration pages, while others may require you to edit your configuration file (.htconfig.php). +Some addons allow you to enter this information in the site administration pages, while others may require you to edit your configuration file (.htconfig.php). The ways to obtain these keys vary between the services, but they all require an existing account on the target service. Once installed, these API keys can usually be shared by all site members. -The details of configuring each service follow (much of this information comes directly from the plugin source files): +The details of configuring each service follow (much of this information comes directly from the addon source files): -Twitter Plugin for Friendica +Twitter Addon for Friendica --- * Author: Tobias Diekershoff @@ -33,7 +33,7 @@ Twitter Plugin for Friendica * License: 3-clause BSD license ###Configuration -To use this plugin you need a OAuth Consumer key pair (key & secret). +To use this addon you need a OAuth Consumer key pair (key & secret). You can get it from [Twitter](https://twitter.com/apps). Register your Friendica site as "Client" application with "Read & Write" access. @@ -51,7 +51,7 @@ After this, your users can configure their Twitter account settings from "Settin Find the author's documentation here: [http://diekershoff.homeunix.net/redmine/wiki/friendikaplugin/Twitter_Plugin](http://diekershoff.homeunix.net/redmine/wiki/friendikaplugin/Twitter_Plugin) -GNU Social Plugin for Friendica +GNU Social Addon for Friendica --- * Author: Tobias Diekershoff diff --git a/doc/Settings.md b/doc/Settings.md index a0b33d76d2..a574e0675c 100644 --- a/doc/Settings.md +++ b/doc/Settings.md @@ -14,7 +14,7 @@ These worker tasks are prioritised and are done accordingly. Then you get an overview of the accounts on your node, which can be moderated in the "Users" section of the panel. As well as an overview of the currently active addons -The list is linked, so you can have quick access to the plugin settings. +The list is linked, so you can have quick access to the Addon settings. And finally you are informed about the version of Friendica you have installed. If you contact the devs with a bug or problem, please also mention the version of your node. @@ -205,7 +205,7 @@ Here the admin can also block/unblock users from accessing the node or delete th In the last section of the page admins can create new accounts on the node. The password for the new account will be send by email to the choosen email address. -## Plugins +## Addons This page is for selecting and configuration of extensions for Friendica which have to be placed into the `/addon` subdirectory of your Friendica installation. You are presented with a long list of available addons. @@ -213,11 +213,11 @@ The name of each addon is linked to a separate page for that addon which offers Also shown is the version of the addon and an indicator if the addon is currently active or not. When you update your node and the addons they may have to be reloaded. -To simplify this process there is a button at the top of the page to reload all active plugins. +To simplify this process there is a button at the top of the page to reload all active Addons. ## Themes -The Themes section of the admin panel works similar to the Plugins section but let you control the themes on your Friendica node. +The Themes section of the admin panel works similar to the Addons section but let you control the themes on your Friendica node. Each theme has a dedicated subpage showing the current status, some information about the theme and a screen-shot of the Friendica interface using the theme. Should the theme offer special settings, admins can set a global default value here. @@ -266,7 +266,7 @@ To do so, they need to know the GUID of the posting. This can be found on the `/display` page of the posting, it is the last part of the URL displayed in the browsers navigation bar. You can get to the `/display` page by following the *Link to source*. -## Plugin Features +## Addon Features Some of the addons you can install for your Friendica node have settings which have to be set by the admin. All those addons will be listed in this area of the admin panels side bar with their names. diff --git a/doc/database.md b/doc/database.md index e778a0a721..b58fba9d98 100644 --- a/doc/database.md +++ b/doc/database.md @@ -5,7 +5,7 @@ Database Tables | Table | Description | |------------------------------------------------------|--------------------------------------------------| -| [addon](help/database/db_addon) | registered plugins | +| [addon](help/database/db_addon) | registered addons | | [attach](help/database/db_attach) | file attachments | | [auth_codes](help/database/db_auth_codes) | OAuth usage | | [cache](help/database/db_cache) | OEmbed cache | @@ -24,7 +24,7 @@ Database Tables | [group](help/database/db_group) | privacy groups, group info | | [group_member](help/database/db_group_member) | privacy groups, member info | | [gserver](help/database/db_gserver) | | -| [hook](help/database/db_hook) | plugin hook registry | +| [hook](help/database/db_hook) | addon hook registry | | [intro](help/database/db_intro) | | | [item](help/database/db_item) | all posts | | [locks](help/database/db_locks) | | diff --git a/doc/database/db_addon.md b/doc/database/db_addon.md index 099abbf642..cd8a3d44a6 100644 --- a/doc/database/db_addon.md +++ b/doc/database/db_addon.md @@ -4,7 +4,7 @@ Table addon | Field | Description | Type | Null | Key | Default | Extra | | ------------- | --------------------------------------------- | ---------- | ---- | --- | ------- | --------------- | | id | | int(11) | NO | PRI | NULL | auto_increment | -| name | plugin base (file)name | char(255) | NO | | | | +| name | addon base (file)name | char(255) | NO | | | | | version | currently unused | char(255) | NO | | | | | installed | currently always 1 | tinyint(1) | NO | | 0 | | | hidden | currently unused | tinyint(1) | NO | | 0 | | @@ -12,6 +12,6 @@ Table addon | plugin_admin | 1 = has admin config, 0 = has no admin config | tinyint(1) | NO | | 0 | | Notes: -These are addons which have been enabled by the site administrator on the admin/plugin page +These are addons which have been enabled by the site administrator on the addon page Return to [database documentation](help/database) diff --git a/doc/de/Plugins.md b/doc/de/Addons.md similarity index 53% rename from doc/de/Plugins.md rename to doc/de/Addons.md index 8b1c71177d..f4c14bc613 100644 --- a/doc/de/Plugins.md +++ b/doc/de/Addons.md @@ -1,4 +1,4 @@ -Friendica Addon/Plugin-Entwicklung +Friendica Addon/Entwicklung ============== * [Zur Startseite der Hilfe](help) @@ -8,30 +8,30 @@ Das Facebook-Addon bietet ein Beispiel dafür, die "addon"- und "module"-Funktio Addons arbeiten, indem sie Event Hooks abfangen. Module arbeiten, indem bestimmte Seitenanfragen (durch den URL-Pfad) abgefangen werden. -Plugin-Namen können keine Leerstellen oder andere Interpunktionen enthalten und werden als Datei- und Funktionsnamen genutzt. +Addon-Namen können keine Leerstellen oder andere Interpunktionen enthalten und werden als Datei- und Funktionsnamen genutzt. Du kannst einen lesbaren Namen im Kommentarblock eintragen. -Jedes Addon muss beides beinhalten - eine Installations- und eine Deinstallationsfunktion, die auf dem Addon-/Plugin-Namen basieren; z.B. "plugin1name_install()". -Diese beiden Funktionen haben keine Argumente und sind dafür verantwortlich, Event Hooks zu registrieren und abzumelden (unregistering), die dein Plugin benötigt. -Die Installations- und Deinstallationsfunktionfunktionen werden auch ausgeführt (z.B. neu installiert), wenn sich das Plugin nach der Installation ändert - somit sollte deine Deinstallationsfunktion keine Daten zerstört und deine Installationsfunktion sollte bestehende Daten berücksichtigen. +Jedes Addon muss beides beinhalten - eine Installations- und eine Deinstallationsfunktion, die auf dem Addon-Namen basieren; z.B. "addon1name_install()". +Diese beiden Funktionen haben keine Argumente und sind dafür verantwortlich, Event Hooks zu registrieren und abzumelden (unregistering), die dein Addon benötigt. +Die Installations- und Deinstallationsfunktionfunktionen werden auch ausgeführt (z.B. neu installiert), wenn sich das Addon nach der Installation ändert - somit sollte deine Deinstallationsfunktion keine Daten zerstört und deine Installationsfunktion sollte bestehende Daten berücksichtigen. Zukünftige Extensions werden möglicherweise "Setup" und "Entfernen" anbieten. -Plugins sollten einen Kommentarblock mit den folgenden vier Parametern enthalten: +Addons sollten einen Kommentarblock mit den folgenden vier Parametern enthalten: /* - * Name: My Great Plugin - * Description: This is what my plugin does. It's really cool. + * Name: My Great Addon + * Description: This is what my addon does. It's really cool. * Version: 1.0 * Author: John Q. Public */ -Registriere deine Plugin-Hooks während der Installation. +Registriere deine Addon-Hooks während der Installation. - register_hook($hookname, $file, $function); + Addon::registerHook($hookname, $file, $function); $hookname ist ein String und entspricht einem bekannten Friendica-Hook. $file steht für den Pfadnamen, der relativ zum Top-Level-Friendicaverzeichnis liegt. -Das *sollte* "addon/plugin_name/plugin_name.php' sein. +Das *sollte* "addon/addon_name/addon_name.php' sein. $function ist ein String und der Name der Funktion, die ausgeführt wird, wenn der Hook aufgerufen wird. @@ -57,19 +57,19 @@ Achte darauf, diese mit "&" zu deklarieren, wenn du sie bearbeiten willst. Module --- -Plugins/Addons können auch als "Module" agieren und alle Seitenanfragen für eine bestimte URL abfangen. -Um ein Plugin als Modul zu nutzen, ist es nötig, die Funktion "plugin_name_module()" zu definieren, die keine Argumente benötigt und nichts weiter machen muss. +Addons können auch als "Module" agieren und alle Seitenanfragen für eine bestimte URL abfangen. +Um ein Addon als Modul zu nutzen, ist es nötig, die Funktion "addon_name_module()" zu definieren, die keine Argumente benötigt und nichts weiter machen muss. -Wenn diese Funktion existiert, wirst du nun alle Seitenanfragen für "http://example.com/plugin_name" erhalten - mit allen URL-Komponenten als zusätzliche Argumente. +Wenn diese Funktion existiert, wirst du nun alle Seitenanfragen für "http://example.com/addon_name" erhalten - mit allen URL-Komponenten als zusätzliche Argumente. Diese werden in ein Array $a->argv geparst und stimmen mit $a->argc überein, wobei sie die Anzahl der URL-Komponenten abbilden. -So würde http://example.com/plugin/arg1/arg2 nach einem Modul "plugin" suchen und seiner Modulfunktion die $a-App-Strukur übergeben (dies ist für viele Komponenten verfügbar). Das umfasst: +So würde http://example.com/addon/arg1/arg2 nach einem Modul "addon" suchen und seiner Modulfunktion die $a-App-Strukur übergeben (dies ist für viele Komponenten verfügbar). Das umfasst: $a->argc = 3 - $a->argv = array(0 => 'plugin', 1 => 'arg1', 2 => 'arg2'); + $a->argv = array(0 => 'addon', 1 => 'arg1', 2 => 'arg2'); -Deine Modulfunktionen umfassen oft die Funktion plugin_name_content(App $a), welche den Seiteninhalt definiert und zurückgibt. -Sie können auch plugin_name_post(App $a) umfassen, welches vor der content-Funktion aufgerufen wird und normalerweise die Resultate der POST-Formulare handhabt. -Du kannst ebenso plugin_name_init(App $a) nutzen, was oft frühzeitig aufgerufen wird und das Modul initialisert. +Deine Modulfunktionen umfassen oft die Funktion addon_name_content(App $a), welche den Seiteninhalt definiert und zurückgibt. +Sie können auch addon_name_post(App $a) umfassen, welches vor der content-Funktion aufgerufen wird und normalerweise die Resultate der POST-Formulare handhabt. +Du kannst ebenso addon_name_init(App $a) nutzen, was oft frühzeitig aufgerufen wird und das Modul initialisert. Derzeitige Hooks @@ -109,10 +109,10 @@ Derzeitige Hooks **'settings_post'** - wird aufgerufen, wenn die Einstellungsseiten geladen werden. $b ist der $_POST-Array -**'plugin_settings'** - wird aufgerufen, wenn die HTML-Ausgabe der Addon-Einstellungsseite generiert wird. +**'addon_settings'** - wird aufgerufen, wenn die HTML-Ausgabe der Addon-Einstellungsseite generiert wird. $b ist die HTML-Ausgabe (String) der Addon-Einstellungsseite vor dem finalen ""-Tag. -**'plugin_settings_post'** - wird aufgerufen, wenn die Addon-Einstellungsseite geladen wird. +**'addon_settings_post'** - wird aufgerufen, wenn die Addon-Einstellungsseite geladen wird. $b ist der $_POST-Array **'profile_post'** - wird aufgerufen, wenn die Profilseite angezeigt wird. @@ -191,180 +191,176 @@ Komplette Liste der Hook-Callbacks Eine komplette Liste aller Hook-Callbacks mit den zugehörigen Dateien (am 14-Feb-2012 generiert): Bitte schau in die Quellcodes für Details zu Hooks, die oben nicht dokumentiert sind. -boot.php: call_hooks('login_hook',$o); +boot.php: Addon::callHooks('login_hook',$o); -boot.php: call_hooks('profile_sidebar_enter', $profile); +boot.php: Addon::callHooks('profile_sidebar_enter', $profile); -boot.php: call_hooks('profile_sidebar', $arr); +boot.php: Addon::callHooks('profile_sidebar', $arr); -boot.php: call_hooks("proc_run", $arr); +boot.php: Addon::callHooks("proc_run", $arr); -include/contact_selectors.php: call_hooks('network_to_name', $nets); +include/contact_selectors.php: Addon::callHooks('network_to_name', $nets); -include/api.php: call_hooks('logged_in', $a->user); +include/api.php: Addon::callHooks('logged_in', $a->user); -include/api.php: call_hooks('logged_in', $a->user); +include/api.php: Addon::callHooks('logged_in', $a->user); -include/queue.php: call_hooks('queue_predeliver', $a, $r); +include/queue.php: Addon::callHooks('queue_predeliver', $a, $r); -include/queue.php: call_hooks('queue_deliver', $a, $params); +include/queue.php: Addon::callHooks('queue_deliver', $a, $params); -include/text.php: call_hooks('contact_block_end', $arr); +include/text.php: Addon::callHooks('contact_block_end', $arr); -include/text.php: call_hooks('smilie', $s); +include/text.php: Addon::callHooks('smilie', $s); -include/text.php: call_hooks('prepare_body_init', $item); +include/text.php: Addon::callHooks('prepare_body_init', $item); -include/text.php: call_hooks('prepare_body', $prep_arr); +include/text.php: Addon::callHooks('prepare_body', $prep_arr); -include/text.php: call_hooks('prepare_body_final', $prep_arr); +include/text.php: Addon::callHooks('prepare_body_final', $prep_arr); -include/nav.php: call_hooks('page_header', $a->page['nav']); +include/nav.php: Addon::callHooks('page_header', $a->page['nav']); -include/auth.php: call_hooks('authenticate', $addon_auth); +include/auth.php: Addon::callHooks('authenticate', $addon_auth); -include/bbcode.php: call_hooks('bbcode',$Text); +include/bbcode.php: Addon::callHooks('bbcode',$Text); -include/oauth.php: call_hooks('logged_in', $a->user); +include/oauth.php: Addon::callHooks('logged_in', $a->user); -include/acl_selectors.php: call_hooks($a->module . '_pre_' . $selname, $arr); +include/acl_selectors.php: Addon::callHooks($a->module . '_pre_' . $selname, $arr); -include/acl_selectors.php: call_hooks($a->module . '_post_' . $selname, $o); +include/acl_selectors.php: Addon::callHooks($a->module . '_post_' . $selname, $o); -include/acl_selectors.php: call_hooks('contact_select_options', $x); +include/acl_selectors.php: Addon::callHooks('contact_select_options', $x); -include/acl_selectors.php: call_hooks($a->module . '_pre_' . $selname, $arr); +include/acl_selectors.php: Addon::callHooks($a->module . '_pre_' . $selname, $arr); -include/acl_selectors.php: call_hooks($a->module . '_post_' . $selname, $o); +include/acl_selectors.php: Addon::callHooks($a->module . '_post_' . $selname, $o); -include/acl_selectors.php: call_hooks($a->module . '_pre_' . $selname, $arr); +include/acl_selectors.php: Addon::callHooks($a->module . '_pre_' . $selname, $arr); -include/acl_selectors.php: call_hooks($a->module . '_post_' . $selname, $o); +include/acl_selectors.php: Addon::callHooks($a->module . '_post_' . $selname, $o); -include/notifier.php: call_hooks('notifier_normal',$target_item); +include/notifier.php: Addon::callHooks('notifier_normal',$target_item); -include/notifier.php: call_hooks('notifier_end',$target_item); +include/notifier.php: Addon::callHooks('notifier_end',$target_item); -include/items.php: call_hooks('atom_feed', $atom); +include/items.php: Addon::callHooks('atom_feed', $atom); -include/items.php: call_hooks('atom_feed_end', $atom); +include/items.php: Addon::callHooks('atom_feed_end', $atom); -include/items.php: call_hooks('atom_feed_end', $atom); +include/items.php: Addon::callHooks('atom_feed_end', $atom); -include/items.php: call_hooks('parse_atom', $arr); +include/items.php: Addon::callHooks('parse_atom', $arr); -include/items.php: call_hooks('post_remote',$arr); +include/items.php: Addon::callHooks('post_remote',$arr); -include/items.php: call_hooks('atom_author', $o); +include/items.php: Addon::callHooks('atom_author', $o); -include/items.php: call_hooks('atom_entry', $o); +include/items.php: Addon::callHooks('atom_entry', $o); -include/bb2diaspora.php: call_hooks('bb2diaspora',$Text); +include/bb2diaspora.php: Addon::callHooks('bb2diaspora',$Text); -include/cronhooks.php: call_hooks('cron', $d); +include/cronhooks.php: Addon::callHooks('cron', $d); -include/security.php: call_hooks('logged_in', $a->user); +include/security.php: Addon::callHooks('logged_in', $a->user); -include/html2bbcode.php: call_hooks('html2bbcode', $text); +include/html2bbcode.php: Addon::callHooks('html2bbcode', $text); -include/Contact.php: call_hooks('remove_user',$r[0]); +include/Contact.php: Addon::callHooks('remove_user',$r[0]); -include/Contact.php: call_hooks('contact_photo_menu', $args); +include/Contact.php: Addon::callHooks('contact_photo_menu', $args); -include/conversation.php: call_hooks('conversation_start',$cb); +include/conversation.php: Addon::callHooks('conversation_start',$cb); -include/conversation.php: call_hooks('render_location',$locate); +include/conversation.php: Addon::callHooks('render_location',$locate); -include/conversation.php: call_hooks('display_item', $arr); +include/conversation.php: Addon::callHooks('display_item', $arr); -include/conversation.php: call_hooks('render_location',$locate); +include/conversation.php: Addon::callHooks('render_location',$locate); -include/conversation.php: call_hooks('display_item', $arr); +include/conversation.php: Addon::callHooks('display_item', $arr); -include/conversation.php: call_hooks('item_photo_menu', $args); +include/conversation.php: Addon::callHooks('item_photo_menu', $args); -include/conversation.php: call_hooks('jot_tool', $jotplugins); +include/conversation.php: Addon::callHooks('jot_tool', $jotplugins); -include/conversation.php: call_hooks('jot_networks', $jotnets); +include/conversation.php: Addon::callHooks('jot_networks', $jotnets); -include/plugin.php: if(! function_exists('call_hooks')) { +index.php: Addon::callHooks('init_1'); -include/plugin.php:function call_hooks($name, &$data = null) { +index.php: Addon::callHooks('app_menu', $arr); -index.php: call_hooks('init_1'); +index.php: Addon::callHooks('page_end', $a->page['content']); -index.php: call_hooks('app_menu', $arr); +mod/photos.php: Addon::callHooks('photo_post_init', $_POST); -index.php: call_hooks('page_end', $a->page['content']); +mod/photos.php: Addon::callHooks('photo_post_file',$ret); -mod/photos.php: call_hooks('photo_post_init', $_POST); +mod/photos.php: Addon::callHooks('photo_post_end',$foo); -mod/photos.php: call_hooks('photo_post_file',$ret); +mod/photos.php: Addon::callHooks('photo_post_end',$foo); -mod/photos.php: call_hooks('photo_post_end',$foo); +mod/photos.php: Addon::callHooks('photo_post_end',$foo); -mod/photos.php: call_hooks('photo_post_end',$foo); +mod/photos.php: Addon::callHooks('photo_post_end',intval($item_id)); -mod/photos.php: call_hooks('photo_post_end',$foo); +mod/photos.php: Addon::callHooks('photo_upload_form',$ret); -mod/photos.php: call_hooks('photo_post_end',intval($item_id)); +mod/friendica.php: Addon::callHooks('about_hook', $o); -mod/photos.php: call_hooks('photo_upload_form',$ret); +mod/editpost.php: Addon::callHooks('jot_tool', $jotplugins); -mod/friendica.php: call_hooks('about_hook', $o); +mod/editpost.php: Addon::callHooks('jot_networks', $jotnets); -mod/editpost.php: call_hooks('jot_tool', $jotplugins); +mod/parse_url.php: Addon::callHooks('parse_link', $arr); -mod/editpost.php: call_hooks('jot_networks', $jotnets); +mod/home.php: Addon::callHooks('home_init',$ret); -mod/parse_url.php: call_hooks('parse_link', $arr); +mod/home.php: Addon::callHooks("home_content",$o); -mod/home.php: call_hooks('home_init',$ret); +mod/contacts.php: Addon::callHooks('contact_edit_post', $_POST); -mod/home.php: call_hooks("home_content",$o); +mod/contacts.php: Addon::callHooks('contact_edit', $arr); -mod/contacts.php: call_hooks('contact_edit_post', $_POST); +mod/settings.php: Addon::callHooks('addon_settings_post', $_POST); -mod/contacts.php: call_hooks('contact_edit', $arr); +mod/settings.php: Addon::callHooks('connector_settings_post', $_POST); -mod/settings.php: call_hooks('plugin_settings_post', $_POST); +mod/settings.php: Addon::callHooks('settings_post', $_POST); -mod/settings.php: call_hooks('connector_settings_post', $_POST); +mod/settings.php: Addon::callHooks('addon_settings', $settings_addons); -mod/settings.php: call_hooks('settings_post', $_POST); +mod/settings.php: Addon::callHooks('connector_settings', $settings_connectors); -mod/settings.php: call_hooks('plugin_settings', $settings_addons); +mod/settings.php: Addon::callHooks('settings_form',$o); -mod/settings.php: call_hooks('connector_settings', $settings_connectors); +mod/register.php: Addon::callHooks('register_account', $newuid); -mod/settings.php: call_hooks('settings_form',$o); +mod/like.php: Addon::callHooks('post_local_end', $arr); -mod/register.php: call_hooks('register_account', $newuid); +mod/xrd.php: Addon::callHooks('personal_xrd', $arr); -mod/like.php: call_hooks('post_local_end', $arr); +mod/item.php: Addon::callHooks('post_local_start', $_REQUEST); -mod/xrd.php: call_hooks('personal_xrd', $arr); +mod/item.php: Addon::callHooks('post_local',$datarray); -mod/item.php: call_hooks('post_local_start', $_REQUEST); +mod/item.php: Addon::callHooks('post_local_end', $datarray); -mod/item.php: call_hooks('post_local',$datarray); +mod/profile.php: Addon::callHooks('profile_advanced',$o); -mod/item.php: call_hooks('post_local_end', $datarray); +mod/profiles.php: Addon::callHooks('profile_post', $_POST); -mod/profile.php: call_hooks('profile_advanced',$o); +mod/profiles.php: Addon::callHooks('profile_edit', $arr); -mod/profiles.php: call_hooks('profile_post', $_POST); +mod/tagger.php: Addon::callHooks('post_local_end', $arr); -mod/profiles.php: call_hooks('profile_edit', $arr); +mod/cb.php: Addon::callHooks('cb_init'); -mod/tagger.php: call_hooks('post_local_end', $arr); +mod/cb.php: Addon::callHooks('cb_post', $_POST); -mod/cb.php: call_hooks('cb_init'); +mod/cb.php: Addon::callHooks('cb_afterpost'); -mod/cb.php: call_hooks('cb_post', $_POST); +mod/cb.php: Addon::callHooks('cb_content', $o); -mod/cb.php: call_hooks('cb_afterpost'); - -mod/cb.php: call_hooks('cb_content', $o); - -mod/directory.php: call_hooks('directory_item', $arr); +mod/directory.php: Addon::callHooks('directory_item', $arr); diff --git a/doc/de/Chats.md b/doc/de/Chats.md index ae239a675b..fc46af650e 100644 --- a/doc/de/Chats.md +++ b/doc/de/Chats.md @@ -8,9 +8,9 @@ Du hast derzeit zwei Möglichkeiten, einen Chat auf Deiner Friendica-Seite zu be * IRC - Internet Relay Chat * Jappix -##IRC Plugin +##IRC Addon -Sobald das Plugin aktiviert ist, kannst Du den Chat unter [deineSeite.de/irc](../irc) finden. +Sobald das Addon aktiviert ist, kannst Du den Chat unter [deineSeite.de/irc](../irc) finden. Beachte aber, dass dieser Chat auch ohne Anmeldung auf Deiner Seite zugänglich ist und somit auch Fremde diesen Chat mitnutzen können. Wenn Du dem Link folgst, dann kommst Du zum Anmeldefenster des IR-Chats. @@ -29,7 +29,7 @@ Weiter Informationen zu IRC findest Du zum Beispiel auf einfachjabber.de. @@ -53,15 +53,15 @@ oder als normaler Download von hier: https://github.com/friendica/friendica-addo Entpacke diese Datei (ggf. den entpackten Ordner in „jappixmini“ umbenennen) und lade sowohl den entpackten Ordner komplett als auch die .tgz Datei in den Addon Ordner Deiner Friendica Installation hoch. -Nach dem Upload gehts in den Friendica Adminbereich und dort zu den Plugins. -Aktiviere das Jappixmini Addon und gehe anschließend über die Plugins Seitenleiste (dort wo auch die Twitter-, Impressums-, GNU Social-, usw. Einstellungen gemacht werden) zu den Jappix Grundeinstellungen. +Nach dem Upload gehts in den Friendica Adminbereich und dort zu den Addons. +Aktiviere das Jappixmini Addon und gehe anschließend über die Addons Seitenleiste (dort wo auch die Twitter-, Impressums-, GNU Social-, usw. Einstellungen gemacht werden) zu den Jappix Grundeinstellungen. Setze hier den Haken zur Aktivierung des BOSH Proxys. Weiter gehts in den Einstellungen Deines Friendica Accounts. 2. Einstellungen -Gehe bitte zu den Plugin-Einstellungen in Deinen Konto-Einstellungen (Account Settings). +Gehe bitte zu den Addon-Einstellungen in Deinen Konto-Einstellungen (Account Settings). Scrolle ein Stück hinunter bis zu den Jappix Mini Addon settings. Aktiviere hier zuerst das Addon. diff --git a/doc/de/FAQ.md b/doc/de/FAQ.md index e78e8bc21a..aa9d01b64d 100644 --- a/doc/de/FAQ.md +++ b/doc/de/FAQ.md @@ -104,7 +104,7 @@ Ignorierte Kontakte können weiterhin Beiträge und private Nachrichten von Dir Deren Beiträge und private Nachrichten werden allerdings nicht importiert. Wie bei blockierten Beiträgen siehst Du auch hier weiterhin die Kommentare dieser Person zu anderen Beiträgen Deiner Freunde. -[Ein Plugin namens "blockem" kann installiert werden, um alle Beiträge einer bestimmten Person in Deinem Stream zu verstecken bzw. zu verkürzen. +[Ein Erweiterung namens "blockem" kann installiert werden, um alle Beiträge einer bestimmten Person in Deinem Stream zu verstecken bzw. zu verkürzen. Dabei werden auch Kommentare dieser Person in Beiträgen Deiner Freunde blockiert.] Ein archivierter Kontakt bedeutet, dass Kommunikation nicht möglich ist und auch nicht versucht wird (das ist z.B. sinnvoll, wenn eine Person zu einem neuen Server gewechselt ist und das alte Profil gelöscht hat). diff --git a/doc/de/Home.md b/doc/de/Home.md index 67ca15ebcd..403cc1477e 100644 --- a/doc/de/Home.md +++ b/doc/de/Home.md @@ -30,7 +30,7 @@ Friendica - Dokumentation und Ressourcen * [Installation](help/Install) * [Update](help/Update) (EN) * [Konfigurationen & Admin-Panel](help/Settings) -* [Plugins](help/Plugins) +* [Addons](help/Addons) * [Konnektoren (Connectors) installieren (Twitter/GNU Social)](help/Installing-Connectors) * [Installation eines ejabberd Servers (XMPP-Chat) mit synchronisierten Anmeldedaten](help/install-ejabberd) (EN) * [Betreibe deine Seite mit einem SSL-Zertifikat](help/SSL) @@ -45,7 +45,7 @@ Friendica - Dokumentation und Ressourcen * [Help on Vagrant](help/Vagrant) * [How to translate Friendica](help/translations) (EN) * [Bugs and Issues](help/Bugs-and-Issues) -* [Plugin Development](help/Plugins) +* [Addon Development](help/Addons) * [Theme Development](help/themes) * [Smarty 3 Templates](help/smarty3-templates) * [Protokoll Dokumentation](help/Protocol) (EN) diff --git a/doc/de/Improve-Performance.md b/doc/de/Improve-Performance.md index e4bbbffb5b..c1f0a54fa0 100644 --- a/doc/de/Improve-Performance.md +++ b/doc/de/Improve-Performance.md @@ -28,10 +28,10 @@ Der Nachteil: Du siehst nicht jede Antwort einer OStatus-Unterhaltung. Aus diese Wenn du MyISAM (Standardeinstellung) oder InnoDB mit MariaDB 10 nutzt, dann beschleunigt dies die Suche. -Plugins +Addons -------- -Aktiviere die folgenden Plugins: +Aktiviere die folgenden Addons: rendertime @@ -39,7 +39,7 @@ Aktiviere die folgenden Plugins: **Beschreibung** -Dieses Plugin beschleunigt dein System nicht, aber es hilft dabei, die Flaschenhälse zu ermitteln. +Dieses Addon beschleunigt dein System nicht, aber es hilft dabei, die Flaschenhälse zu ermitteln. Wenn es aktiviert ist, dann siehst du Werte wie die folgenden auf jeder deiner Seiten: diff --git a/doc/de/Installing-Connectors.md b/doc/de/Installing-Connectors.md index 76daa685fb..f9fe5b0f72 100644 --- a/doc/de/Installing-Connectors.md +++ b/doc/de/Installing-Connectors.md @@ -3,29 +3,29 @@ Konnektoren installieren (Twitter/GNU Social) * [Zur Startseite der Hilfe](help) -Friendica nutzt Plugins, um die Verbindung zu anderen Netzwerken wie Twitter oder App.net zu gewährleisten. +Friendica nutzt Erweiterung, um die Verbindung zu anderen Netzwerken wie Twitter oder App.net zu gewährleisten. -Es gibt außerdem ein Plugin, um über einen bestehenden GNU Social-Account diesen Service zu nutzen. -Du brauchst dieses Plugin aber nicht, um mit GNU Social-Mitgliedern von Friendica aus zu kommunizieren - es sei denn, du wünschst es, über einen existierenden Account einen Beitrag zu schreiben. +Es gibt außerdem ein Erweiterung, um über einen bestehenden GNU Social-Account diesen Service zu nutzen. +Du brauchst dieses Erweiterung aber nicht, um mit GNU Social-Mitgliedern von Friendica aus zu kommunizieren - es sei denn, du wünschst es, über einen existierenden Account einen Beitrag zu schreiben. -Alle drei Plugins benötigen einen Account im gewünschten Netzwerk. +Alle drei Erweiterung benötigen einen Account im gewünschten Netzwerk. Zusätzlich musst du (bzw. der Administrator der Seite) einen API-Schlüssel holen, um einen authentifizierten Zugriff zu deinem Friendica-Server herstellen zu lassen. **Seitenkonfiguration** -Plugins müssen vom Administrator installiert werden, bevor sie genutzt werden können. +Erweiterung müssen vom Administrator installiert werden, bevor sie genutzt werden können. Dieses kann über das Administrationsmenü erstellt werden. Jeder der Konnektoren benötigt zudem einen API-Schlüssel vom Service, der verbunden werden soll. -Einige Plugins erlaube es, diese Informationen auf den Administrationsseiten einzustellen, wohingegen andere eine direkte Bearbeitung der Konfigurationsdatei ".htconfig.php" erfordern. +Einige Erweiterung erlaube es, diese Informationen auf den Administrationsseiten einzustellen, wohingegen andere eine direkte Bearbeitung der Konfigurationsdatei ".htconfig.php" erfordern. Der Weg, um diese Schlüssel zu erhalten, variiert stark, jedoch brauchen fast alle einen bestehenden Account im gewünschten Service. Einmal installiert, können diese Schlüssel von allen Seitennutzern genutzt werden. -Im Folgenden findest du die Einstellungen für die verschiedenen Services (viele dieser Informationen kommen direkt aus den Quelldateien der Plugins): +Im Folgenden findest du die Einstellungen für die verschiedenen Services (viele dieser Informationen kommen direkt aus den Quelldateien der Erweiterung): -**Twitter Plugin für Friendica** +**Twitter Erweiterung für Friendica** * Author: Tobias Diekershoff * tobias.diekershoff@gmx.net @@ -33,7 +33,7 @@ Im Folgenden findest du die Einstellungen für die verschiedenen Services (viele * License:3-clause BSD license Konfiguration: -Um dieses Plugin zu nutzen, benötigst du einen OAuth Consumer-Schlüsselpaar (Schlüssel und Geheimnis), das du auf der Seite [https://twitter.com/apps](https://twitter.com/apps) erhalten kannst +Um dieses Erweiterung zu nutzen, benötigst du einen OAuth Consumer-Schlüsselpaar (Schlüssel und Geheimnis), das du auf der Seite [https://twitter.com/apps](https://twitter.com/apps) erhalten kannst Registriere deine Friendica-Seite als "Client"-Anwendung mit "Read&Write"-Zugriff. Wir benötigen "Twitter als Login" nicht. Sobald du deine Anwendung installiert hast, erhältst du das Schlüsselpaar für deine Seite. @@ -47,7 +47,7 @@ $a->config['twitter']['consumersecret'] = 'your consumer_secret here'; Anschließend kann der Nutzer deiner Seite die Twitter-Einstellungen selbst eintragen: "Einstellungen -> Connector Einstellungen". -**GNU Social Plugin für Friendica** +**GNU Social Erweiterung für Friendica** * Author: Tobias Diekershoff * tobias.diekershoff@gmx.net diff --git a/doc/de/Settings.md b/doc/de/Settings.md index 91cad094cc..1c7a487431 100644 --- a/doc/de/Settings.md +++ b/doc/de/Settings.md @@ -195,7 +195,7 @@ An dieser Stelle kannst du existierende Accounts vom Zugriff auf die Instanz blo Im letzten Bereich auf der Seite kannst du als Administrator neue Accounts anlegen. Das Passwort für so eingerichtete Accounts werden per E-Mail an die Nutzer geschickt. -## Plugins +## Addons Dieser Bereich des Admin Panels dient der Auswahl und Konfiguration der Erweiterungen von Friendica. Sie müssen in das `/addon` Verzeichnis kopiert werden. @@ -203,11 +203,11 @@ Auf der Seite wird eine Liste der verfügbaren Erweiterungen angezeigt. Neben den Namen der Erweiterungen wird ein Indikator angezeigt, der anzeigt ob das Addon gerade aktiviert ist oder nicht. Wenn du die Erweiterungen aktualisiert die du auf deiner Friendica-Instanz nutzt könnte es sein, dass sie neu geladen werden müssen, damit die Änderungen aktiviert werden. -Um diesen Prozess zu vereinfachen gibt es am Anfang der Seite einen Button um alle aktiven Plugins neu zu laden. +Um diesen Prozess zu vereinfachen gibt es am Anfang der Seite einen Button um alle aktiven Addons neu zu laden. ## Themen -Der Bereich zur Kontrolle der auf der Friendica-Instanz verfügbaren Themen funktioniert analog zum Plugins Bereich. +Der Bereich zur Kontrolle der auf der Friendica-Instanz verfügbaren Themen funktioniert analog zum Addons Bereich. Jedes Theme hat eine extra Seite auf der der aktuelle Status, ein Bildschirmfoto des Themes, zusätzliche Informationen und eventuelle Einstellungen des Themes zu finden sind. Genau wie Erweiterungen können Themes in der Übersichtsliste oder der Theme-Seite aktiviert bzw. deaktiviert werden. Um ein Standardtheme für die Instanz zu wählen, benutze bitte die *Seiten* Bereich des Admin Panels. @@ -256,7 +256,7 @@ Dazu muss man nur die GUID des Beitrags kennen. Diese kann u.a. in der Adresse der `/display`-Seite gefunden werden, wenn man dem *Link zum Originalbeitrag* folgt. Hier ist die GUID der letzte Teil der URL in der Adresszeile des Browsers. -## Plugin Features +## Addon Features Einige der Erweiterungen von Friendica benötigen global gültige Einstellungen, die der Administrator vornehmen muss. Diese Erweiterungen sind hier aufgelistet, damit du die Einstellungen schneller findest. diff --git a/include/acl_selectors.php b/include/acl_selectors.php index 5be3fd1f3f..caa3e98c23 100644 --- a/include/acl_selectors.php +++ b/include/acl_selectors.php @@ -5,6 +5,7 @@ use Friendica\App; use Friendica\Content\Feature; use Friendica\Content\Widget; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Database\DBM; use Friendica\Model\Contact; @@ -32,7 +33,7 @@ function group_select($selname,$selclass,$preselected = false,$size = 4) { // e.g. 'network_pre_group_deny', 'profile_pre_group_allow' - call_hooks($a->module . '_pre_' . $selname, $arr); + Addon::callHooks($a->module . '_pre_' . $selname, $arr); if (DBM::is_result($r)) { foreach ($r as $rr) { @@ -50,7 +51,7 @@ function group_select($selname,$selclass,$preselected = false,$size = 4) { } $o .= "\r\n"; - call_hooks($a->module . '_post_' . $selname, $o); + Addon::callHooks($a->module . '_post_' . $selname, $o); return $o; @@ -111,7 +112,7 @@ function contact_selector($selname, $selclass, $options, $preselected = false) $x = ['options' => $options, 'size' => $size, 'single' => $single, 'mutual' => $mutual, 'exclude' => $exclude, 'networks' => $networks]; - call_hooks('contact_select_options', $x); + Addon::callHooks('contact_select_options', $x); $o = ''; @@ -154,7 +155,7 @@ function contact_selector($selname, $selclass, $options, $preselected = false) // e.g. 'network_pre_contact_deny', 'profile_pre_contact_allow' - call_hooks($a->module . '_pre_' . $selname, $arr); + Addon::callHooks($a->module . '_pre_' . $selname, $arr); if (DBM::is_result($r)) { foreach ($r as $rr) { @@ -173,7 +174,7 @@ function contact_selector($selname, $selclass, $options, $preselected = false) $o .= "\r\n"; - call_hooks($a->module . '_post_' . $selname, $o); + Addon::callHooks($a->module . '_post_' . $selname, $o); return $o; } @@ -232,7 +233,7 @@ function contact_select($selname, $selclass, $preselected = false, $size = 4, $p // e.g. 'network_pre_contact_deny', 'profile_pre_contact_allow' - call_hooks($a->module . '_pre_' . $selname, $arr); + Addon::callHooks($a->module . '_pre_' . $selname, $arr); $receiverlist = []; @@ -263,7 +264,7 @@ function contact_select($selname, $selclass, $preselected = false, $size = 4, $p $o .= implode(", ", $receiverlist); } - call_hooks($a->module . '_post_' . $selname, $o); + Addon::callHooks($a->module . '_post_' . $selname, $o); return $o; } @@ -353,7 +354,7 @@ function populate_acl($user = null, $show_jotnets = false) { $jotnets .= '
' . t("Post to Email") . '
'; } - call_hooks('jot_networks', $jotnets); + Addon::callHooks('jot_networks', $jotnets); } else { $jotnets .= sprintf(t('Connectors disabled, since "%s" is enabled.'), t('Hide your profile details from unknown viewers?')); @@ -671,7 +672,7 @@ function acl_lookup(App $a, $out_type = 'json') 'search' => $search, ]; - call_hooks('acl_lookup_end', $results); + Addon::callHooks('acl_lookup_end', $results); if ($out_type === 'html') { $o = [ diff --git a/include/api.php b/include/api.php index b4fdb646f9..15ec2db12c 100644 --- a/include/api.php +++ b/include/api.php @@ -8,6 +8,7 @@ use Friendica\App; use Friendica\Content\ContactSelector; use Friendica\Content\Feature; +use Friendica\Core\Addon; use Friendica\Core\System; use Friendica\Core\Config; use Friendica\Core\NotificationsManager; @@ -166,7 +167,7 @@ function api_login(App $a) list($consumer, $token) = $oauth1->verify_request(OAuthRequest::from_request()); if (!is_null($token)) { $oauth1->loginUser($token->uid); - call_hooks('logged_in', $a->user); + Addon::callHooks('logged_in', $a->user); return; } echo __FILE__.__LINE__.__FUNCTION__ . "
";
@@ -212,11 +213,11 @@ function api_login(App $a)
 	];
 
 	/*
-		* A plugin indicates successful login by setting 'authenticated' to non-zero value and returning a user record
-		* Plugins should never set 'authenticated' except to indicate success - as hooks may be chained
-		* and later plugins should not interfere with an earlier one that succeeded.
-		*/
-	call_hooks('authenticate', $addon_auth);
+	* An addon indicates successful login by setting 'authenticated' to non-zero value and returning a user record
+	* Addons should never set 'authenticated' except to indicate success - as hooks may be chained
+	* and later addons should not interfere with an earlier one that succeeded.
+	*/
+	Addon::callHooks('authenticate', $addon_auth);
 
 	if ($addon_auth['authenticated'] && count($addon_auth['user_record'])) {
 		$record = $addon_auth['user_record'];
@@ -239,7 +240,7 @@ function api_login(App $a)
 
 	$_SESSION["allow_api"] = true;
 
-	call_hooks('logged_in', $a->user);
+	Addon::callHooks('logged_in', $a->user);
 }
 
 /**
diff --git a/include/bb2diaspora.php b/include/bb2diaspora.php
index fc25a584a9..4856d18ab1 100644
--- a/include/bb2diaspora.php
+++ b/include/bb2diaspora.php
@@ -1,6 +1,7 @@
 
  • ', '
  • ', $Text); //$Text = str_replace('
    $items, 'mode' => $mode, 'update' => $update, 'preview' => $preview]; - call_hooks('conversation_start',$cb); + Addon::callHooks('conversation_start',$cb); $items = $cb['items']; @@ -731,7 +732,7 @@ function conversation(App $a, $items, $mode, $update, $preview = false) { } $locate = ['location' => $item['location'], 'coord' => $item['coord'], 'html' => '']; - call_hooks('render_location',$locate); + Addon::callHooks('render_location',$locate); $location = ((strlen($locate['html'])) ? $locate['html'] : render_location_dummy($locate)); @@ -820,7 +821,7 @@ function conversation(App $a, $items, $mode, $update, $preview = false) { ]; $arr = ['item' => $item, 'output' => $tmp_item]; - call_hooks('display_item', $arr); + Addon::callHooks('display_item', $arr); $threads[$threadsid]['id'] = $item['item_id']; $threads[$threadsid]['network'] = $item['item_network']; @@ -864,7 +865,7 @@ function conversation(App $a, $items, $mode, $update, $preview = false) { continue; } - call_hooks('display_item', $arr); + Addon::callHooks('display_item', $arr); $item['pagedrop'] = $page_dropping; @@ -1075,7 +1076,7 @@ function item_photo_menu($item) { $args = ['item' => $item, 'menu' => $menu]; - call_hooks('item_photo_menu', $args); + Addon::callHooks('item_photo_menu', $args); $menu = $args['menu']; @@ -1297,7 +1298,7 @@ function status_editor(App $a, $x, $notes_cid = 0, $popup = false) ]); $jotplugins = ''; - call_hooks('jot_tool', $jotplugins); + Addon::callHooks('jot_tool', $jotplugins); // Private/public post links for the non-JS ACL form $private_post = 1; diff --git a/include/enotify.php b/include/enotify.php index 286a372e9c..ab4bbc6db2 100644 --- a/include/enotify.php +++ b/include/enotify.php @@ -3,6 +3,7 @@ * @file include/enotify.php */ use Friendica\App; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Core\System; use Friendica\Database\DBM; @@ -398,7 +399,7 @@ function notification($params) 'itemlink' => $itemlink ]; - call_hooks('enotify', $h); + Addon::callHooks('enotify', $h); $subject = $h['subject']; @@ -440,7 +441,7 @@ function notification($params) $datarray['otype'] = $params['otype']; $datarray['abort'] = false; - call_hooks('enotify_store', $datarray); + Addon::callHooks('enotify_store', $datarray); if ($datarray['abort']) { pop_lang(); @@ -576,7 +577,7 @@ function notification($params) $datarray['subject'] = $subject; $datarray['headers'] = $additional_mail_header; - call_hooks('enotify_mail', $datarray); + Addon::callHooks('enotify_mail', $datarray); // check whether sending post content in email notifications is allowed // always true for SYSTEM_EMAIL @@ -667,7 +668,7 @@ function check_user_notification($itemid) { */ function check_item_notification($itemid, $uid, $defaulttype = "") { $notification_data = ["uid" => $uid, "profiles" => []]; - call_hooks('check_item_notification', $notification_data); + Addon::callHooks('check_item_notification', $notification_data); $profiles = $notification_data["profiles"]; diff --git a/include/event.php b/include/event.php index d4c97c750c..64ccf3f53c 100644 --- a/include/event.php +++ b/include/event.php @@ -6,6 +6,7 @@ use Friendica\App; use Friendica\Content\Feature; +use Friendica\Core\Addon; use Friendica\Core\PConfig; use Friendica\Core\System; use Friendica\Database\DBM; @@ -328,7 +329,7 @@ function event_store($arr) { $item_id = 0; } - call_hooks("event_updated", $arr['id']); + Addon::callHooks("event_updated", $arr['id']); return $item_id; } else { @@ -406,7 +407,7 @@ function event_store($arr) { ); } - call_hooks("event_created", $event['id']); + Addon::callHooks("event_created", $event['id']); return $item_id; } diff --git a/include/friendica_smarty.php b/include/friendica_smarty.php index 1992a3716e..a7d153e309 100644 --- a/include/friendica_smarty.php +++ b/include/friendica_smarty.php @@ -1,9 +1,8 @@ basename($s->filename), "vars" => $r ]; - call_hooks("template_vars", $arr); + Addon::callHooks("template_vars", $arr); $r = $arr['vars']; foreach ($r as $key => $value) { diff --git a/include/html2bbcode.php b/include/html2bbcode.php index 75f05f453d..2404e42f6b 100644 --- a/include/html2bbcode.php +++ b/include/html2bbcode.php @@ -8,6 +8,7 @@ * https://github.com/annando/Syncom */ +use Friendica\Core\Addon; use Friendica\Util\XML; function node2bbcode(&$doc, $oldnode, $attributes, $startbb, $endbb) @@ -261,7 +262,7 @@ function html2bbcode($message, $basepath = '') $message = preg_replace('=\r *\r=i', "\n", $message); $message = str_replace("\r", "\n", $message); - call_hooks('html2bbcode', $message); + Addon::callHooks('html2bbcode', $message); $message = strip_tags($message); diff --git a/include/items.php b/include/items.php index e99799ad66..8063f7fc2d 100644 --- a/include/items.php +++ b/include/items.php @@ -4,6 +4,7 @@ */ use Friendica\App; use Friendica\Content\Feature; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Core\PConfig; use Friendica\Core\Worker; @@ -157,7 +158,7 @@ function title_is_body($title, $body) { } function add_page_info_data($data) { - call_hooks('page_info_data', $data); + Addon::callHooks('page_info_data', $data); // It maybe is a rich content, but if it does have everything that a link has, // then treat it that way @@ -600,7 +601,7 @@ function item_store($arr, $force_parent = false, $notify = false, $dontcache = f } /// @TODO old-lost code? - // Shouldn't happen but we want to make absolutely sure it doesn't leak from a plugin. + // Shouldn't happen but we want to make absolutely sure it doesn't leak from an addon. // Deactivated, since the bbcode parser can handle with it - and it destroys posts with some smileys that contain "<" //if ((strpos($arr['body'],'<') !== false) || (strpos($arr['body'],'>') !== false)) // $arr['body'] = strip_tags($arr['body']); @@ -943,9 +944,9 @@ function item_store($arr, $force_parent = false, $notify = false, $dontcache = f put_item_in_cache($arr); if ($notify) { - call_hooks('post_local', $arr); + Addon::callHooks('post_local', $arr); } else { - call_hooks('post_remote', $arr); + Addon::callHooks('post_remote', $arr); } // This array field is used to trigger some automatic reactions @@ -953,7 +954,7 @@ function item_store($arr, $force_parent = false, $notify = false, $dontcache = f unset($arr['api_source']); if (x($arr, 'cancel')) { - logger('item_store: post cancelled by plugin.'); + logger('item_store: post cancelled by addon.'); return 0; } @@ -1086,9 +1087,9 @@ function item_store($arr, $force_parent = false, $notify = false, $dontcache = f $r = q('SELECT * FROM `item` WHERE `id` = %d', intval($current_post)); if ((DBM::is_result($r)) && (count($r) == 1)) { if ($notify) { - call_hooks('post_local_end', $r[0]); + Addon::callHooks('post_local_end', $r[0]); } else { - call_hooks('post_remote_end', $r[0]); + Addon::callHooks('post_remote_end', $r[0]); } } else { logger('item_store: new item not found in DB, id ' . $current_post); @@ -1364,7 +1365,7 @@ function tag_deliver($uid, $item_id) $arr = ['item' => $item, 'user' => $u[0], 'contact' => $r[0]]; - call_hooks('tagged', $arr); + Addon::callHooks('tagged', $arr); if ((! $community_page) && (! $prvgroup)) { return; diff --git a/include/like.php b/include/like.php index f89b7a82e6..1dbdcc936d 100644 --- a/include/like.php +++ b/include/like.php @@ -1,6 +1,7 @@ strings = []; - // load enabled plugins strings - $plugins = dba::select('addon', ['name'], ['installed' => true]); - while ($p = dba::fetch($plugins)) { + // load enabled addons strings + $addons = dba::select('addon', ['name'], ['installed' => true]); + while ($p = dba::fetch($addons)) { $name = $p['name']; if (file_exists("addon/$name/lang/$lang/strings.php")) { include("addon/$name/lang/$lang/strings.php"); diff --git a/include/plugin.php b/include/plugin.php deleted file mode 100644 index 0059b7d86e..0000000000 --- a/include/plugin.php +++ /dev/null @@ -1,467 +0,0 @@ - $plugin]); - - @include_once('addon/' . $plugin . '/' . $plugin . '.php'); - if (function_exists($plugin . '_uninstall')) { - $func = $plugin . '_uninstall'; - $func(); - } -} - -/** - * @brief installs an addon. - * - * @param string $plugin name of the addon - * @return bool - */ -function install_plugin($plugin) { - // silently fail if plugin was removed - - if (!file_exists('addon/' . $plugin . '/' . $plugin . '.php')) { - return false; - } - logger("Addons: installing " . $plugin); - $t = @filemtime('addon/' . $plugin . '/' . $plugin . '.php'); - @include_once('addon/' . $plugin . '/' . $plugin . '.php'); - if (function_exists($plugin . '_install')) { - $func = $plugin . '_install'; - $func(); - - $plugin_admin = (function_exists($plugin."_plugin_admin") ? 1 : 0); - - dba::insert('addon', ['name' => $plugin, 'installed' => true, - 'timestamp' => $t, 'plugin_admin' => $plugin_admin]); - - // we can add the following with the previous SQL - // once most site tables have been updated. - // This way the system won't fall over dead during the update. - - if (file_exists('addon/' . $plugin . '/.hidden')) { - dba::update('addon', ['hidden' => true], ['name' => $plugin]); - } - return true; - } else { - logger("Addons: FAILED installing " . $plugin); - return false; - } -} - -// reload all updated plugins - -function reload_plugins() { - $plugins = Config::get('system', 'addon'); - if (strlen($plugins)) { - - $r = q("SELECT * FROM `addon` WHERE `installed` = 1"); - if (DBM::is_result($r)) { - $installed = $r; - } else { - $installed = []; - } - - $parr = explode(',',$plugins); - - if (count($parr)) { - foreach ($parr as $pl) { - - $pl = trim($pl); - - $fname = 'addon/' . $pl . '/' . $pl . '.php'; - - if (file_exists($fname)) { - $t = @filemtime($fname); - foreach ($installed as $i) { - if (($i['name'] == $pl) && ($i['timestamp'] != $t)) { - logger('Reloading plugin: ' . $i['name']); - @include_once($fname); - - if (function_exists($pl . '_uninstall')) { - $func = $pl . '_uninstall'; - $func(); - } - if (function_exists($pl . '_install')) { - $func = $pl . '_install'; - $func(); - } - dba::update('addon', ['timestamp' => $t], ['id' => $i['id']]); - } - } - } - } - } - } - -} - -/** - * @brief check if addon is enabled - * - * @param string $plugin - * @return boolean - */ -function plugin_enabled($plugin) { - return dba::exists('addon', ['installed' => true, 'name' => $plugin]); -} - - -/** - * @brief registers a hook. - * - * @param string $hook the name of the hook - * @param string $file the name of the file that hooks into - * @param string $function the name of the function that the hook will call - * @param int $priority A priority (defaults to 0) - * @return mixed|bool - */ -function register_hook($hook, $file, $function, $priority=0) { - $condition = ['hook' => $hook, 'file' => $file, 'function' => $function]; - $exists = dba::exists('hook', $condition); - if ($exists) { - return true; - } - - $r = dba::insert('hook', ['hook' => $hook, 'file' => $file, 'function' => $function, 'priority' => $priority]); - - return $r; -} - -/** - * @brief unregisters a hook. - * - * @param string $hook the name of the hook - * @param string $file the name of the file that hooks into - * @param string $function the name of the function that the hook called - * @return array - */ -function unregister_hook($hook, $file, $function) { - $condition = ['hook' => $hook, 'file' => $file, 'function' => $function]; - $r = dba::delete('hook', $condition); - return $r; -} - - -function load_hooks() { - $a = get_app(); - $a->hooks = []; - $r = dba::select('hook', ['hook', 'file', 'function'], [], ['order' => ['priority' => 'desc', 'file']]); - - while ($rr = dba::fetch($r)) { - if (! array_key_exists($rr['hook'],$a->hooks)) { - $a->hooks[$rr['hook']] = []; - } - $a->hooks[$rr['hook']][] = [$rr['file'],$rr['function']]; - } - dba::close($r); -} - -/** - * @brief Calls a hook. - * - * Use this function when you want to be able to allow a hook to manipulate - * the provided data. - * - * @param string $name of the hook to call - * @param string|array &$data to transmit to the callback handler - */ -function call_hooks($name, &$data = null) -{ - $a = get_app(); - - if (is_array($a->hooks) && array_key_exists($name, $a->hooks)) { - foreach ($a->hooks[$name] as $hook) { - call_single_hook($a, $name, $hook, $data); - } - } -} - -/** - * @brief Calls a single hook. - * - * @param string $name of the hook to call - * @param array $hook Hook data - * @param string|array &$data to transmit to the callback handler - */ -function call_single_hook($a, $name, $hook, &$data = null) { - // Don't run a theme's hook if the user isn't using the theme - if (strpos($hook[0], 'view/theme/') !== false && strpos($hook[0], 'view/theme/'.current_theme()) === false) - return; - - @include_once($hook[0]); - if (function_exists($hook[1])) { - $func = $hook[1]; - $func($a, $data); - } else { - // remove orphan hooks - $condition = ['hook' => $name, 'file' => $hook[0], 'function' => $hook[1]]; - dba::delete('hook', $condition); - } -} - -//check if an app_menu hook exist for plugin $name. -//Return true if the plugin is an app -function plugin_is_app($name) { - $a = get_app(); - - if (is_array($a->hooks) && (array_key_exists('app_menu',$a->hooks))) { - foreach ($a->hooks['app_menu'] as $hook) { - if ($hook[0] == 'addon/'.$name.'/'.$name.'.php') - return true; - } - } - - return false; -} - -/** - * @brief Parse plugin comment in search of plugin infos. - * - * like - * \code - *...* Name: Plugin - * * Description: A plugin which plugs in - * . * Version: 1.2.3 - * * Author: John - * * Author: Jane - * * - * *\endcode - * @param string $plugin the name of the plugin - * @return array with the plugin information - */ - -function get_plugin_info($plugin) { - - $a = get_app(); - - $info=[ - 'name' => $plugin, - 'description' => "", - 'author' => [], - 'version' => "", - 'status' => "" - ]; - - if (!is_file("addon/$plugin/$plugin.php")) return $info; - - $stamp1 = microtime(true); - $f = file_get_contents("addon/$plugin/$plugin.php"); - $a->save_timestamp($stamp1, "file"); - - $r = preg_match("|/\*.*\*/|msU", $f, $m); - - if ($r) { - $ll = explode("\n", $m[0]); - foreach ( $ll as $l ) { - $l = trim($l,"\t\n\r */"); - if ($l != "") { - list($k,$v) = array_map("trim", explode(":",$l,2)); - $k= strtolower($k); - if ($k == "author") { - $r=preg_match("|([^<]+)<([^>]+)>|", $v, $m); - if ($r) { - $info['author'][] = ['name'=>$m[1], 'link'=>$m[2]]; - } else { - $info['author'][] = ['name'=>$v]; - } - } else { - if (array_key_exists($k,$info)) { - $info[$k]=$v; - } - } - - } - } - - } - return $info; -} - - -/** - * @brief Parse theme comment in search of theme infos. - * - * like - * \code - * ..* Name: My Theme - * * Description: My Cool Theme - * . * Version: 1.2.3 - * * Author: John - * * Maintainer: Jane - * * - * \endcode - * @param string $theme the name of the theme - * @return array - */ - -function get_theme_info($theme) { - $info=[ - 'name' => $theme, - 'description' => "", - 'author' => [], - 'maintainer' => [], - 'version' => "", - 'credits' => "", - 'experimental' => false, - 'unsupported' => false - ]; - - if (file_exists("view/theme/$theme/experimental")) - $info['experimental'] = true; - if (file_exists("view/theme/$theme/unsupported")) - $info['unsupported'] = true; - - if (!is_file("view/theme/$theme/theme.php")) return $info; - - $a = get_app(); - $stamp1 = microtime(true); - $f = file_get_contents("view/theme/$theme/theme.php"); - $a->save_timestamp($stamp1, "file"); - - $r = preg_match("|/\*.*\*/|msU", $f, $m); - - if ($r) { - $ll = explode("\n", $m[0]); - foreach ( $ll as $l ) { - $l = trim($l,"\t\n\r */"); - if ($l != "") { - list($k,$v) = array_map("trim", explode(":",$l,2)); - $k= strtolower($k); - if ($k == "author") { - - $r=preg_match("|([^<]+)<([^>]+)>|", $v, $m); - if ($r) { - $info['author'][] = ['name'=>$m[1], 'link'=>$m[2]]; - } else { - $info['author'][] = ['name'=>$v]; - } - } elseif ($k == "maintainer") { - $r=preg_match("|([^<]+)<([^>]+)>|", $v, $m); - if ($r) { - $info['maintainer'][] = ['name'=>$m[1], 'link'=>$m[2]]; - } else { - $info['maintainer'][] = ['name'=>$v]; - } - } else { - if (array_key_exists($k,$info)) { - $info[$k]=$v; - } - } - - } - } - - } - return $info; -} - -/** - * @brief Returns the theme's screenshot. - * - * The screenshot is expected as view/theme/$theme/screenshot.[png|jpg]. - * - * @param sring $theme The name of the theme - * @return string - */ -function get_theme_screenshot($theme) { - $exts = ['.png','.jpg']; - foreach ($exts as $ext) { - if (file_exists('view/theme/' . $theme . '/screenshot' . $ext)) { - return(System::baseUrl() . '/view/theme/' . $theme . '/screenshot' . $ext); - } - } - return(System::baseUrl() . '/images/blank.png'); -} - -// install and uninstall theme -function uninstall_theme($theme) { - logger("Addons: uninstalling theme " . $theme); - - include_once("view/theme/$theme/theme.php"); - if (function_exists("{$theme}_uninstall")) { - $func = "{$theme}_uninstall"; - $func(); - } -} - -function install_theme($theme) { - // silently fail if theme was removed - - if (! file_exists("view/theme/$theme/theme.php")) { - return false; - } - - logger("Addons: installing theme $theme"); - - include_once("view/theme/$theme/theme.php"); - - if (function_exists("{$theme}_install")) { - $func = "{$theme}_install"; - $func(); - return true; - } else { - logger("Addons: FAILED installing theme $theme"); - return false; - } - -} - -/** - * @brief Get the full path to relevant theme files by filename - * - * This function search in the theme directory (and if not present in global theme directory) - * if there is a directory with the file extension and for a file with the given - * filename. - * - * @param string $file Filename - * @param string $root Full root path - * @return string Path to the file or empty string if the file isn't found - */ -function theme_include($file, $root = '') { - $file = basename($file); - - // Make sure $root ends with a slash / if it's not blank - if ($root !== '' && $root[strlen($root)-1] !== '/') { - $root = $root . '/'; - } - $theme_info = get_app()->theme_info; - if (is_array($theme_info) && array_key_exists('extends',$theme_info)) { - $parent = $theme_info['extends']; - } else { - $parent = 'NOPATH'; - } - $theme = current_theme(); - $thname = $theme; - $ext = substr($file,strrpos($file,'.')+1); - $paths = [ - "{$root}view/theme/$thname/$ext/$file", - "{$root}view/theme/$parent/$ext/$file", - "{$root}view/$ext/$file", - ]; - foreach ($paths as $p) { - // strpos() is faster than strstr when checking if one string is in another (http://php.net/manual/en/function.strstr.php) - if (strpos($p,'NOPATH') !== false) { - continue; - } elseif (file_exists($p)) { - return $p; - } - } - return ''; -} diff --git a/include/security.php b/include/security.php index 5c393cbb62..d1387ca226 100644 --- a/include/security.php +++ b/include/security.php @@ -1,6 +1,7 @@ user); + Addon::callHooks('logged_in', $a->user); if (($a->module !== 'home') && isset($_SESSION['return_url'])) { goaway(System::baseUrl() . '/' . $_SESSION['return_url']); diff --git a/include/text.php b/include/text.php index 5ce0b850ef..6856d28aa3 100644 --- a/include/text.php +++ b/include/text.php @@ -6,6 +6,7 @@ use Friendica\App; use Friendica\Content\ContactSelector; use Friendica\Content\Feature; use Friendica\Content\Smilies; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Core\PConfig; use Friendica\Core\System; @@ -969,7 +970,7 @@ function contact_block() { $arr = ['contacts' => $r, 'output' => $o]; - call_hooks('contact_block_end', $arr); + Addon::callHooks('contact_block_end', $arr); return $o; } @@ -1123,7 +1124,7 @@ function get_poke_verbs() { 'finger' => ['fingered', t('finger'), t('fingered')], 'rebuff' => ['rebuffed', t('rebuff'), t('rebuffed')], ]; - call_hooks('poke_verbs', $arr); + Addon::callHooks('poke_verbs', $arr); return $arr; } @@ -1255,7 +1256,7 @@ function put_item_in_cache(&$item, $update = false) function prepare_body(&$item, $attach = false, $preview = false) { $a = get_app(); - call_hooks('prepare_body_init', $item); + Addon::callHooks('prepare_body_init', $item); $searchpath = System::baseUrl() . "/search?tag="; @@ -1314,7 +1315,7 @@ function prepare_body(&$item, $attach = false, $preview = false) { $s = $item["rendered-html"]; $prep_arr = ['item' => $item, 'html' => $s, 'preview' => $preview]; - call_hooks('prepare_body', $prep_arr); + Addon::callHooks('prepare_body', $prep_arr); $s = $prep_arr['html']; if (! $attach) { @@ -1432,7 +1433,7 @@ function prepare_body(&$item, $attach = false, $preview = false) { } $prep_arr = ['item' => $item, 'html' => $s]; - call_hooks('prepare_body_final', $prep_arr); + Addon::callHooks('prepare_body_final', $prep_arr); return $prep_arr['html']; } diff --git a/index.php b/index.php index dcb25cc3a3..ad65a701ac 100644 --- a/index.php +++ b/index.php @@ -11,7 +11,9 @@ use Friendica\App; use Friendica\BaseObject; use Friendica\Content\Nav; +use Friendica\Core\Addon; use Friendica\Core\System; +use Friendica\Core\Theme; use Friendica\Core\Config; use Friendica\Core\Worker; use Friendica\Database\DBM; @@ -75,8 +77,8 @@ if (!$install) { } require_once 'include/session.php'; - load_hooks(); - call_hooks('init_1'); + Addon::loadHooks(); + Addon::callHooks('init_1'); $maintenance = Config::get('system', 'maintenance'); } @@ -178,7 +180,7 @@ if (! x($_SESSION, 'last_updated')) { /* * check_config() is responsible for running update scripts. These automatically * update the DB schema whenever we push a new one out. It also checks to see if - * any plugins have been added or removed and reacts accordingly. + * any addons have been added or removed and reacts accordingly. */ // in install mode, any url loads install module @@ -190,7 +192,7 @@ if ($install && $a->module!="view") { } else { check_url($a); check_db(false); - check_plugins($a); + check_addons($a); } Nav::setSelected('nothing'); @@ -200,7 +202,7 @@ $privateapps = Config::get('config', 'private_addons'); if ((local_user()) || (! $privateapps === "1")) { $arr = ['app_menu' => $a->apps]; - call_hooks('app_menu', $arr); + Addon::callHooks('app_menu', $arr); $a->apps = $arr['app_menu']; } @@ -226,7 +228,7 @@ if (strlen($a->module)) { /** * We will always have a module name. - * First see if we have a plugin which is masquerading as a module. + * First see if we have an addon which is masquerading as a module. */ // Compatibility with the Android Diaspora client @@ -241,9 +243,9 @@ if (strlen($a->module)) { $privateapps = Config::get('config', 'private_addons'); - if (is_array($a->plugins) && in_array($a->module, $a->plugins) && file_exists("addon/{$a->module}/{$a->module}.php")) { + if (is_array($a->addons) && in_array($a->module, $a->addons) && file_exists("addon/{$a->module}/{$a->module}.php")) { //Check if module is an app and if public access to apps is allowed or not - if ((!local_user()) && plugin_is_app($a->module) && $privateapps === "1") { + if ((!local_user()) && Addon::isApp($a->module) && $privateapps === "1") { info(t("You must be logged in to use addons. ")); } else { include_once "addon/{$a->module}/{$a->module}.php"; @@ -317,7 +319,7 @@ if (! x($a->page, 'content')) { } if (!$install && !$maintenance) { - call_hooks('page_content_top', $a->page['content']); + Addon::callHooks('page_content_top', $a->page['content']); } /** @@ -329,10 +331,10 @@ if ($a->module_loaded) { $placeholder = ''; if ($a->module_class) { - call_hooks($a->module . '_mod_init', $placeholder); + Addon::callHooks($a->module . '_mod_init', $placeholder); call_user_func([$a->module_class, 'init']); } else if (function_exists($a->module . '_init')) { - call_hooks($a->module . '_mod_init', $placeholder); + Addon::callHooks($a->module . '_mod_init', $placeholder); $func = $a->module . '_init'; $func($a); } @@ -343,7 +345,7 @@ if ($a->module_loaded) { } if (! $a->error && $_SERVER['REQUEST_METHOD'] === 'POST') { - call_hooks($a->module . '_mod_post', $_POST); + Addon::callHooks($a->module . '_mod_post', $_POST); if ($a->module_class) { call_user_func([$a->module_class, 'post']); } else if (function_exists($a->module . '_post')) { @@ -353,7 +355,7 @@ if ($a->module_loaded) { } if (! $a->error) { - call_hooks($a->module . '_mod_afterpost', $placeholder); + Addon::callHooks($a->module . '_mod_afterpost', $placeholder); if ($a->module_class) { call_user_func([$a->module_class, 'afterpost']); } else if (function_exists($a->module . '_afterpost')) { @@ -364,7 +366,7 @@ if ($a->module_loaded) { if (! $a->error) { $arr = ['content' => $a->page['content']]; - call_hooks($a->module . '_mod_content', $arr); + Addon::callHooks($a->module . '_mod_content', $arr); $a->page['content'] = $arr['content']; if ($a->module_class) { $arr = ['content' => call_user_func([$a->module_class, 'content'])]; @@ -372,7 +374,7 @@ if ($a->module_loaded) { $func = $a->module . '_content'; $arr = ['content' => $func($a)]; } - call_hooks($a->module . '_mod_aftercontent', $arr); + Addon::callHooks($a->module . '_mod_aftercontent', $arr); $a->page['content'] .= $arr['content']; } @@ -421,7 +423,7 @@ if (stristr(implode("", $_SESSION['sysmsg']), t('Permission denied'))) { /* * Report anything which needs to be communicated in the notification area (before the main body) */ -call_hooks('page_end', $a->page['content']); +Addon::callHooks('page_end', $a->page['content']); /* * Add the navigation (menu) template @@ -516,15 +518,15 @@ header('X-Frame-Options: sameorigin'); * The page templates are located in /view/php/ or in the theme directory. */ if (isset($_GET["mode"])) { - $template = theme_include($_GET["mode"] . '.php'); + $template = Theme::getPathForFile($_GET["mode"] . '.php'); } // If there is no page template use the default page template if (empty($template)) { - $template = theme_include("default.php"); + $template = Theme::getPathForFile("default.php"); } -/// @TODO Looks unsafe (remote-inclusion), is maybe not but theme_include() uses file_exists() but does not escape anything +/// @TODO Looks unsafe (remote-inclusion), is maybe not but Theme::getPathForFile() uses file_exists() but does not escape anything require_once $template; killme(); diff --git a/mod/admin.php b/mod/admin.php index 9c286c11dd..4544917010 100644 --- a/mod/admin.php +++ b/mod/admin.php @@ -8,8 +8,10 @@ use Friendica\App; use Friendica\Content\Feature; use Friendica\Content\Text\Markdown; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Core\System; +use Friendica\Core\Theme; use Friendica\Core\Worker; use Friendica\Database\DBM; use Friendica\Database\DBStructure; @@ -56,16 +58,16 @@ function admin_post(App $a) case 'users': admin_page_users_post($a); break; - case 'plugins': + case 'addons': if ($a->argc > 2 && is_file("addon/" . $a->argv[2] . "/" . $a->argv[2] . ".php")) { @include_once("addon/" . $a->argv[2] . "/" . $a->argv[2] . ".php"); - if (function_exists($a->argv[2] . '_plugin_admin_post')) { - $func = $a->argv[2] . '_plugin_admin_post'; + if (function_exists($a->argv[2] . '_addon_admin_post')) { + $func = $a->argv[2] . '_addon_admin_post'; $func($a); } } - $return_path = 'admin/plugins/' . $a->argv[2]; + $return_path = 'admin/addons/' . $a->argv[2]; break; case 'themes': if ($a->argc < 2) { @@ -170,7 +172,7 @@ function admin_content(App $a) $aside_sub = [ 'site' => ["admin/site/" , t("Site") , "site"], 'users' => ["admin/users/" , t("Users") , "users"], - 'plugins' => ["admin/plugins/" , t("Plugins") , "plugins"], + 'addons' => ["admin/addons/" , t("Addons") , "addons"], 'themes' => ["admin/themes/" , t("Themes") , "themes"], 'features' => ["admin/features/" , t("Additional features") , "features"], 'dbsync' => ["admin/dbsync/" , t('DB updates') , "dbsync"], @@ -181,15 +183,15 @@ function admin_content(App $a) 'deleteitem' => ["admin/deleteitem/" , t('Delete Item') , 'deleteitem'], ]; - /* get plugins admin page */ + /* get addons admin page */ $r = q("SELECT `name` FROM `addon` WHERE `plugin_admin` = 1 ORDER BY `name`"); - $aside_tools['plugins_admin'] = []; + $aside_tools['addons_admin'] = []; foreach ($r as $h) { - $plugin = $h['name']; - $aside_tools['plugins_admin'][] = ["admin/plugins/" . $plugin, $plugin, "plugin"]; - // temp plugins with admin - $a->plugins_admin[] = $plugin; + $addon = $h['name']; + $aside_tools['addons_admin'][] = ["admin/addons/" . $addon, $addon, "addon"]; + // temp addons with admin + $a->addons_admin[] = $addon; } $aside_tools['logs'] = ["admin/logs/", t("Logs"), "logs"]; @@ -202,7 +204,7 @@ function admin_content(App $a) '$admin' => $aside_tools, '$subpages' => $aside_sub, '$admtxt' => t('Admin'), - '$plugadmtxt' => t('Plugin Features'), + '$plugadmtxt' => t('Addon Features'), '$logtxt' => t('Logs'), '$diagnosticstxt' => t('diagnostics'), '$h_pending' => t('User registrations waiting for confirmation'), @@ -220,8 +222,8 @@ function admin_content(App $a) case 'users': $o = admin_page_users($a); break; - case 'plugins': - $o = admin_page_plugins($a); + case 'addons': + $o = admin_page_addons($a); break; case 'themes': $o = admin_page_themes($a); @@ -779,7 +781,7 @@ function admin_page_summary(App $a) '$platform' => FRIENDICA_PLATFORM, '$codename' => FRIENDICA_CODENAME, '$build' => Config::get('system', 'build'), - '$plugins' => [t('Active plugins'), $a->plugins], + '$addons' => [t('Active addons'), $a->addons], '$showwarning' => $showwarning, '$warningtext' => $warningtext ]); @@ -1723,54 +1725,54 @@ function admin_page_users(App $a) } /** - * @brief Plugins admin page + * @brief Addons admin page * - * This function generates the admin panel page for managing plugins on the - * friendica node. If a plugin name is given a single page showing the details + * This function generates the admin panel page for managing addons on the + * friendica node. If an addon name is given a single page showing the details * for this addon is generated. If no name is given, a list of available - * plugins is shown. + * addons is shown. * - * The template used for displaying the list of plugins and the details of the - * plugin are the same as used for the templates. + * The template used for displaying the list of addons and the details of the + * addon are the same as used for the templates. * * The returned string returned hulds the HTML code of the page. * * @param App $a * @return string */ -function admin_page_plugins(App $a) +function admin_page_addons(App $a) { /* - * Single plugin + * Single addon */ if ($a->argc == 3) { - $plugin = $a->argv[2]; - if (!is_file("addon/$plugin/$plugin.php")) { + $addon = $a->argv[2]; + if (!is_file("addon/$addon/$addon.php")) { notice(t("Item not found.")); return ''; } if (x($_GET, "a") && $_GET['a'] == "t") { - check_form_security_token_redirectOnErr('/admin/plugins', 'admin_themes', 't'); + check_form_security_token_redirectOnErr('/admin/addons', 'admin_themes', 't'); - // Toggle plugin status - $idx = array_search($plugin, $a->plugins); + // Toggle addon status + $idx = array_search($addon, $a->addons); if ($idx !== false) { - unset($a->plugins[$idx]); - uninstall_plugin($plugin); - info(t("Plugin %s disabled.", $plugin)); + unset($a->addons[$idx]); + Addon::uninstall($addon); + info(t("Addon %s disabled.", $addon)); } else { - $a->plugins[] = $plugin; - install_plugin($plugin); - info(t("Plugin %s enabled.", $plugin)); + $a->addons[] = $addon; + Addon::install($addon); + info(t("Addon %s enabled.", $addon)); } - Config::set("system", "addon", implode(", ", $a->plugins)); - goaway('admin/plugins'); + Config::set("system", "addon", implode(", ", $a->addons)); + goaway('admin/addons'); return ''; // NOTREACHED } - // display plugin details - if (in_array($plugin, $a->plugins)) { + // display addon details + if (in_array($addon, $a->addons)) { $status = "on"; $action = t("Disable"); } else { @@ -1779,16 +1781,16 @@ function admin_page_plugins(App $a) } $readme = Null; - if (is_file("addon/$plugin/README.md")) { - $readme = Markdown::convert(file_get_contents("addon/$plugin/README.md"), false); - } elseif (is_file("addon/$plugin/README")) { - $readme = "
    " . file_get_contents("addon/$plugin/README") . "
    "; + if (is_file("addon/$addon/README.md")) { + $readme = Markdown::convert(file_get_contents("addon/$addon/README.md"), false); + } elseif (is_file("addon/$addon/README")) { + $readme = "
    " . file_get_contents("addon/$addon/README") . "
    "; } $admin_form = ""; - if (in_array($plugin, $a->plugins_admin)) { - @require_once("addon/$plugin/$plugin.php"); - $func = $plugin . '_plugin_admin'; + if (in_array($addon, $a->addons_admin)) { + @require_once("addon/$addon/$addon.php"); + $func = $addon . '_addon_admin'; $func($a, $admin_form); } @@ -1796,20 +1798,20 @@ function admin_page_plugins(App $a) return replace_macros($t, [ '$title' => t('Administration'), - '$page' => t('Plugins'), + '$page' => t('Addons'), '$toggle' => t('Toggle'), '$settings' => t('Settings'), '$baseurl' => System::baseUrl(true), - '$plugin' => $plugin, + '$addon' => $addon, '$status' => $status, '$action' => $action, - '$info' => get_plugin_info($plugin), + '$info' => Addon::getInfo($addon), '$str_author' => t('Author: '), '$str_maintainer' => t('Maintainer: '), '$admin_form' => $admin_form, - '$function' => 'plugins', + '$function' => 'addons', '$screenshot' => '', '$readme' => $readme, @@ -1818,52 +1820,52 @@ function admin_page_plugins(App $a) } /* - * List plugins + * List addons */ if (x($_GET, "a") && $_GET['a'] == "r") { - check_form_security_token_redirectOnErr(System::baseUrl() . '/admin/plugins', 'admin_themes', 't'); - reload_plugins(); - info("Plugins reloaded"); - goaway(System::baseUrl() . '/admin/plugins'); + check_form_security_token_redirectOnErr(System::baseUrl() . '/admin/addons', 'admin_themes', 't'); + Addon::reload(); + info("Addons reloaded"); + goaway(System::baseUrl() . '/admin/addons'); } - $plugins = []; + $addons = []; $files = glob("addon/*/"); if (is_array($files)) { foreach ($files as $file) { if (is_dir($file)) { list($tmp, $id) = array_map("trim", explode("/", $file)); - $info = get_plugin_info($id); - $show_plugin = true; + $info = Addon::getInfo($id); + $show_addon = true; // If the addon is unsupported, then only show it, when it is enabled - if ((strtolower($info["status"]) == "unsupported") && !in_array($id, $a->plugins)) { - $show_plugin = false; + if ((strtolower($info["status"]) == "unsupported") && !in_array($id, $a->addons)) { + $show_addon = false; } // Override the above szenario, when the admin really wants to see outdated stuff if (Config::get("system", "show_unsupported_addons")) { - $show_plugin = true; + $show_addon = true; } - if ($show_plugin) { - $plugins[] = [$id, (in_array($id, $a->plugins) ? "on" : "off"), $info]; + if ($show_addon) { + $addons[] = [$id, (in_array($id, $a->addons) ? "on" : "off"), $info]; } } } } - $t = get_markup_template('admin/plugins.tpl'); + $t = get_markup_template('admin/addons.tpl'); return replace_macros($t, [ '$title' => t('Administration'), - '$page' => t('Plugins'), + '$page' => t('Addons'), '$submit' => t('Save Settings'), - '$reload' => t('Reload active plugins'), + '$reload' => t('Reload active addons'), '$baseurl' => System::baseUrl(true), - '$function' => 'plugins', - '$plugins' => $plugins, - '$pcount' => count($plugins), - '$noplugshint' => t('There are currently no plugins available on your node. You can find the official plugin repository at %1$s and might find other interesting plugins in the open plugin registry at %2$s', 'https://github.com/friendica/friendica-addons', 'http://addons.friendi.ca'), + '$function' => 'addons', + '$addons' => $addons, + '$pcount' => count($addons), + '$noplugshint' => t('There are currently no addons available on your node. You can find the official addon repository at %1$s and might find other interesting addons in the open addon registry at %2$s', 'https://github.com/friendica/friendica-addons', 'http://addons.friendi.ca'), '$form_security_token' => get_form_security_token("admin_themes"), ]); } @@ -1938,7 +1940,7 @@ function rebuild_theme_table($themes) * themes is generated. * * The template used for displaying the list of themes and the details of the - * themes are the same as used for the plugins. + * themes are the same as used for the addons. * * The returned string contains the HTML code of the admin panel page. * @@ -2006,10 +2008,10 @@ function admin_page_themes(App $a) toggle_theme($themes, $theme, $result); $s = rebuild_theme_table($themes); if ($result) { - install_theme($theme); + Theme::install($theme); info(sprintf('Theme %s enabled.', $theme)); } else { - uninstall_theme($theme); + Theme::uninstall($theme); info(sprintf('Theme %s disabled.', $theme)); } @@ -2057,7 +2059,7 @@ function admin_page_themes(App $a) $a->page = $orig_page; } - $screenshot = [get_theme_screenshot($theme), t('Screenshot')]; + $screenshot = [Theme::getScreenshot($theme), t('Screenshot')]; if (!stristr($screenshot[0], $theme)) { $screenshot = null; } @@ -2069,10 +2071,10 @@ function admin_page_themes(App $a) '$toggle' => t('Toggle'), '$settings' => t('Settings'), '$baseurl' => System::baseUrl(true), - '$plugin' => $theme, + '$addon' => $theme, '$status' => $status, '$action' => $action, - '$info' => get_theme_info($theme), + '$info' => Theme::getInfo($theme), '$function' => 'themes', '$admin_form' => $admin_form, '$str_author' => t('Author: '), @@ -2084,14 +2086,13 @@ function admin_page_themes(App $a) ]); } - // reload active themes if (x($_GET, "a") && $_GET['a'] == "r") { check_form_security_token_redirectOnErr(System::baseUrl() . '/admin/themes', 'admin_themes', 't'); foreach ($themes as $th) { if ($th['allowed']) { - uninstall_theme($th['name']); - install_theme($th['name']); + Theme::uninstall($th['name']); + Theme::install($th['name']); } } info("Themes reloaded"); @@ -2102,12 +2103,12 @@ function admin_page_themes(App $a) * List themes */ - $plugins = []; + $addons = []; foreach ($themes as $th) { - $plugins[] = [$th['name'], (($th['allowed']) ? "on" : "off"), get_theme_info($th['name'])]; + $addons[] = [$th['name'], (($th['allowed']) ? "on" : "off"), Theme::getInfo($th['name'])]; } - $t = get_markup_template('admin/plugins.tpl'); + $t = get_markup_template('admin/addons.tpl'); return replace_macros($t, [ '$title' => t('Administration'), '$page' => t('Themes'), @@ -2115,7 +2116,7 @@ function admin_page_themes(App $a) '$reload' => t('Reload active themes'), '$baseurl' => System::baseUrl(true), '$function' => 'themes', - '$plugins' => $plugins, + '$addons' => $addons, '$pcount' => count($themes), '$noplugshint' => t('No themes found on the system. They should be placed in %1$s', '/view/themes'), '$experimental' => t('[Experimental]'), diff --git a/mod/contacts.php b/mod/contacts.php index 682d427c6d..dfda3a3363 100644 --- a/mod/contacts.php +++ b/mod/contacts.php @@ -6,6 +6,7 @@ use Friendica\App; use Friendica\Content\ContactSelector; use Friendica\Content\Nav; use Friendica\Content\Widget; +use Friendica\Core\Addon; use Friendica\Core\System; use Friendica\Core\Worker; use Friendica\Database\DBM; @@ -173,7 +174,7 @@ function contacts_post(App $a) return; // NOTREACHED } - call_hooks('contact_edit_post', $_POST); + Addon::callHooks('contact_edit_post', $_POST); $profile_id = intval($_POST['profile-assign']); if ($profile_id) { @@ -662,7 +663,7 @@ function contacts_content(App $a) $arr = ['contact' => $contact, 'output' => $o]; - call_hooks('contact_edit', $arr); + Addon::callHooks('contact_edit', $arr); return $arr['output']; } diff --git a/mod/directory.php b/mod/directory.php index 6398127cf5..5afaa08c64 100644 --- a/mod/directory.php +++ b/mod/directory.php @@ -5,6 +5,7 @@ use Friendica\App; use Friendica\Content\Nav; use Friendica\Content\Widget; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Database\DBM; use Friendica\Model\Contact; @@ -174,7 +175,7 @@ function directory_content(App $a) { $arr = ['contact' => $rr, 'entry' => $entry]; - call_hooks('directory_item', $arr); + Addon::callHooks('directory_item', $arr); unset($profile); unset($location); diff --git a/mod/editpost.php b/mod/editpost.php index 117cb3fb19..9e3401e958 100644 --- a/mod/editpost.php +++ b/mod/editpost.php @@ -4,6 +4,7 @@ */ use Friendica\App; use Friendica\Content\Feature; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Core\System; use Friendica\Database\DBM; @@ -94,8 +95,8 @@ function editpost_content(App $a) { - call_hooks('jot_tool', $jotplugins); - //call_hooks('jot_networks', $jotnets); + Addon::callHooks('jot_tool', $jotplugins); + //Addon::callHooks('jot_networks', $jotnets); //$tpl = replace_macros($tpl,array('$jotplugins' => $jotplugins)); diff --git a/mod/friendica.php b/mod/friendica.php index 7f48ae3d4a..318d309e36 100644 --- a/mod/friendica.php +++ b/mod/friendica.php @@ -1,6 +1,7 @@ plugins) && count($a->plugins)) { + $visible_addons = []; + if (is_array($a->addons) && count($a->addons)) { $r = q("SELECT * FROM `addon` WHERE `hidden` = 0"); if (DBM::is_result($r)) { foreach($r as $rr) { - $visible_plugins[] = $rr['name']; + $visible_addons[] = $rr['name']; } } } @@ -50,7 +51,7 @@ function friendica_init(App $a) { $data = [ 'version' => FRIENDICA_VERSION, 'url' => System::baseUrl(), - 'plugins' => $visible_plugins, + 'addons' => $visible_addons, 'locked_features' => $locked_features, 'register_policy' => $register_policy[$a->config['register_policy']], 'admin' => $admin, @@ -83,19 +84,19 @@ function friendica_content(App $a) { $o .= t('Suggestions, praise, donations, etc. - please email "Info" at Friendica - dot com'); $o .= '

    ' . PHP_EOL; - $visible_plugins = []; - if (is_array($a->plugins) && count($a->plugins)) { + $visible_addons = []; + if (is_array($a->addons) && count($a->addons)) { $r = q("SELECT * FROM `addon` WHERE `hidden` = 0"); if (DBM::is_result($r)) { foreach($r as $rr) { - $visible_plugins[] = $rr['name']; + $visible_addons[] = $rr['name']; } } } - if (count($visible_plugins)) { - $o .= '

    ' . t('Installed plugins/addons/apps:') . '

    ' . PHP_EOL; - $sorted = $visible_plugins; + if (count($visible_addons)) { + $o .= '

    ' . t('Installed addons/addons/apps:') . '

    ' . PHP_EOL; + $sorted = $visible_addons; $s = ''; sort($sorted); foreach ($sorted as $p) { @@ -108,7 +109,7 @@ function friendica_content(App $a) { } $o .= '
    ' . $s . '
    ' . PHP_EOL; } else { - $o .= '

    ' . t('No installed plugins/addons/apps') . '

    ' . PHP_EOL; + $o .= '

    ' . t('No installed addons/addons/apps') . '

    ' . PHP_EOL; } $blocklist = Config::get('system', 'blocklist'); @@ -121,7 +122,7 @@ function friendica_content(App $a) { $o .= '' . PHP_EOL; } - call_hooks('about_hook', $o); + Addon::callHooks('about_hook', $o); return $o; } diff --git a/mod/home.php b/mod/home.php index 614fd0e3e8..dc571aaabd 100644 --- a/mod/home.php +++ b/mod/home.php @@ -1,6 +1,7 @@ user['nickname'])) { goaway(System::baseUrl()."/network"); @@ -46,7 +47,7 @@ function home_content(App $a) { $login = Login::form($a->query_string, $a->config['register_policy'] == REGISTER_CLOSED ? 0 : 1); $content = ''; - call_hooks("home_content",$content); + Addon::callHooks("home_content",$content); $tpl = get_markup_template('home.tpl'); diff --git a/mod/item.php b/mod/item.php index bb5b0f1d76..ecf4a83954 100644 --- a/mod/item.php +++ b/mod/item.php @@ -15,6 +15,7 @@ * information. */ use Friendica\App; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Core\System; use Friendica\Core\Worker; @@ -50,7 +51,8 @@ function item_post(App $a) { killme(); } - call_hooks('post_local_start', $_REQUEST); + Addon::callHooks('post_local_start', $_REQUEST); + logger('postvars ' . print_r($_REQUEST,true), LOGGER_DATA); $api_source = defaults($_REQUEST, 'api_source', false); @@ -637,7 +639,7 @@ function item_post(App $a) { $datarray['object'] = $object; /* - * These fields are for the convenience of plugins... + * These fields are for the convenience of addons... * 'self' if true indicates the owner is posting on their own wall * If parent is 0 it is a top-level post. */ @@ -679,10 +681,10 @@ function item_post(App $a) { killme(); } - call_hooks('post_local',$datarray); + Addon::callHooks('post_local',$datarray); if (x($datarray, 'cancel')) { - logger('mod_item: post cancelled by plugin.'); + logger('mod_item: post cancelled by addon.'); if ($return_path) { goaway($return_path); } @@ -792,7 +794,7 @@ function item_post(App $a) { } } - call_hooks('post_local_end', $datarray); + Addon::callHooks('post_local_end', $datarray); if (strlen($emailcc) && $profile_uid == local_user()) { $erecips = explode(',', $emailcc); diff --git a/mod/lockview.php b/mod/lockview.php index ced03d1b56..ead2269c7a 100644 --- a/mod/lockview.php +++ b/mod/lockview.php @@ -1,6 +1,7 @@ '; diff --git a/mod/manage.php b/mod/manage.php index f2781f1081..dde08d3fac 100644 --- a/mod/manage.php +++ b/mod/manage.php @@ -1,6 +1,7 @@ user['nickname'] ); // NOTREACHED diff --git a/mod/network.php b/mod/network.php index c08d8e68d6..6bb1cf387c 100644 --- a/mod/network.php +++ b/mod/network.php @@ -7,6 +7,7 @@ use Friendica\Content\Feature; use Friendica\Content\ForumManager; use Friendica\Content\Nav; use Friendica\Content\Widget; +use Friendica\Core\Addon; use Friendica\Core\System; use Friendica\Core\Config; use Friendica\Core\PConfig; @@ -388,7 +389,7 @@ function network_content(App $a, $update = 0) { /// @TODO Is this really necessary? $a is already available to hooks $arr = ['query' => $a->query_string]; - call_hooks('network_content_init', $arr); + Addon::callHooks('network_content_init', $arr); $nouveau = false; @@ -1006,7 +1007,7 @@ function network_tabs(App $a) } $arr = ['tabs' => $tabs]; - call_hooks('network_tabs', $arr); + Addon::callHooks('network_tabs', $arr); $tpl = get_markup_template('common_tabs.tpl'); diff --git a/mod/nodeinfo.php b/mod/nodeinfo.php index d92335ad13..bcaf8e7a93 100644 --- a/mod/nodeinfo.php +++ b/mod/nodeinfo.php @@ -6,11 +6,10 @@ */ use Friendica\App; +use Friendica\Core\Addon; use Friendica\Core\System; use Friendica\Core\Config; -require_once 'include/plugin.php'; - function nodeinfo_wellknown(App $a) { $nodeinfo = ['links' => [['rel' => 'http://nodeinfo.diaspora.software/ns/schema/1.0', 'href' => System::baseUrl().'/nodeinfo/1.0']]]; @@ -72,48 +71,48 @@ function nodeinfo_init(App $a) { $nodeinfo['usage']['localPosts'] = (int)Config::get('nodeinfo', 'local_posts'); $nodeinfo['usage']['localComments'] = (int)Config::get('nodeinfo', 'local_comments'); - if (plugin_enabled('appnet')) { + if (Addon::isEnabled('appnet')) { $nodeinfo['services']['inbound'][] = 'appnet'; } - if (plugin_enabled('appnet') || plugin_enabled('buffer')) { + if (Addon::isEnabled('appnet') || Addon::isEnabled('buffer')) { $nodeinfo['services']['outbound'][] = 'appnet'; } - if (plugin_enabled('blogger')) { + if (Addon::isEnabled('blogger')) { $nodeinfo['services']['outbound'][] = 'blogger'; } - if (plugin_enabled('dwpost')) { + if (Addon::isEnabled('dwpost')) { $nodeinfo['services']['outbound'][] = 'dreamwidth'; } - if (plugin_enabled('fbpost') || plugin_enabled('buffer')) { + if (Addon::isEnabled('fbpost') || Addon::isEnabled('buffer')) { $nodeinfo['services']['outbound'][] = 'facebook'; } - if (plugin_enabled('statusnet')) { + if (Addon::isEnabled('statusnet')) { $nodeinfo['services']['inbound'][] = 'gnusocial'; $nodeinfo['services']['outbound'][] = 'gnusocial'; } - if (plugin_enabled('gpluspost') || plugin_enabled('buffer')) { + if (Addon::isEnabled('gpluspost') || Addon::isEnabled('buffer')) { $nodeinfo['services']['outbound'][] = 'google'; } - if (plugin_enabled('ijpost')) { + if (Addon::isEnabled('ijpost')) { $nodeinfo['services']['outbound'][] = 'insanejournal'; } - if (plugin_enabled('libertree')) { + if (Addon::isEnabled('libertree')) { $nodeinfo['services']['outbound'][] = 'libertree'; } - if (plugin_enabled('buffer')) { + if (Addon::isEnabled('buffer')) { $nodeinfo['services']['outbound'][] = 'linkedin'; } - if (plugin_enabled('ljpost')) { + if (Addon::isEnabled('ljpost')) { $nodeinfo['services']['outbound'][] = 'livejournal'; } - if (plugin_enabled('buffer')) { + if (Addon::isEnabled('buffer')) { $nodeinfo['services']['outbound'][] = 'pinterest'; } - if (plugin_enabled('posterous')) { + if (Addon::isEnabled('posterous')) { $nodeinfo['services']['outbound'][] = 'posterous'; } - if (plugin_enabled('pumpio')) { + if (Addon::isEnabled('pumpio')) { $nodeinfo['services']['inbound'][] = 'pumpio'; $nodeinfo['services']['outbound'][] = 'pumpio'; } @@ -121,13 +120,13 @@ function nodeinfo_init(App $a) { if ($smtp) { $nodeinfo['services']['outbound'][] = 'smtp'; } - if (plugin_enabled('tumblr')) { + if (Addon::isEnabled('tumblr')) { $nodeinfo['services']['outbound'][] = 'tumblr'; } - if (plugin_enabled('twitter') || plugin_enabled('buffer')) { + if (Addon::isEnabled('twitter') || Addon::isEnabled('buffer')) { $nodeinfo['services']['outbound'][] = 'twitter'; } - if (plugin_enabled('wppost')) { + if (Addon::isEnabled('wppost')) { $nodeinfo['services']['outbound'][] = 'wordpress'; } $nodeinfo['metadata']['protocols'] = $nodeinfo['protocols']; @@ -137,7 +136,7 @@ function nodeinfo_init(App $a) { $nodeinfo['metadata']['services'] = $nodeinfo['services']; - if (plugin_enabled('twitter')) { + if (Addon::isEnabled('twitter')) { $nodeinfo['metadata']['services']['inbound'][] = 'twitter'; } } @@ -153,22 +152,22 @@ function nodeinfo_cron() { $a = get_app(); - // If the plugin 'statistics_json' is enabled then disable it and actrivate nodeinfo. - if (plugin_enabled('statistics_json')) { + // If the addon 'statistics_json' is enabled then disable it and actrivate nodeinfo. + if (Addon::isEnabled('statistics_json')) { Config::set('system', 'nodeinfo', true); - $plugin = 'statistics_json'; - $plugins = Config::get('system', 'addon'); - $plugins_arr = []; + $addon = 'statistics_json'; + $addons = Config::get('system', 'addon'); + $addons_arr = []; - if ($plugins) { - $plugins_arr = explode(',',str_replace(' ', '',$plugins)); + if ($addons) { + $addons_arr = explode(',',str_replace(' ', '',$addons)); - $idx = array_search($plugin, $plugins_arr); + $idx = array_search($addon, $addons_arr); if ($idx !== false) { - unset($plugins_arr[$idx]); - uninstall_plugin($plugin); - Config::set('system', 'addon', implode(', ',$plugins_arr)); + unset($addons_arr[$idx]); + Addon::uninstall($addon); + Config::set('system', 'addon', implode(', ',$addons_arr)); } } } diff --git a/mod/nogroup.php b/mod/nogroup.php index d5da626045..783399f578 100644 --- a/mod/nogroup.php +++ b/mod/nogroup.php @@ -14,8 +14,6 @@ function nogroup_init(App $a) return; } - require_once 'include/contact_widgets.php'; - if (! x($a->page, 'aside')) { $a->page['aside'] = ''; } diff --git a/mod/parse_url.php b/mod/parse_url.php index dbe45aba15..6fb404f1b0 100644 --- a/mod/parse_url.php +++ b/mod/parse_url.php @@ -11,6 +11,7 @@ */ use Friendica\App; +use Friendica\Core\Addon; use Friendica\Util\ParseUrl; require_once("include/items.php"); @@ -91,7 +92,7 @@ function parse_url_content(App $a) { $arr = ["url" => $url, "text" => ""]; - call_hooks("parse_link", $arr); + Addon::callHooks("parse_link", $arr); if (strlen($arr["text"])) { echo $arr["text"]; diff --git a/mod/photos.php b/mod/photos.php index 6183ed60b6..3cb75e539c 100644 --- a/mod/photos.php +++ b/mod/photos.php @@ -5,6 +5,7 @@ use Friendica\App; use Friendica\Content\Feature; use Friendica\Content\Nav; +use Friendica\Core\Addon; use Friendica\Core\System; use Friendica\Core\Config; use Friendica\Core\Worker; @@ -720,7 +721,7 @@ function photos_post(App $a) // default post action - upload a photo - call_hooks('photo_post_init', $_POST); + Addon::callHooks('photo_post_init', $_POST); // Determine the album to use $album = x($_REQUEST, 'album') ? notags(trim($_REQUEST['album'])) : ''; @@ -770,7 +771,7 @@ function photos_post(App $a) $ret = ['src' => '', 'filename' => '', 'filesize' => 0, 'type' => '']; - call_hooks('photo_post_file', $ret); + Addon::callHooks('photo_post_file', $ret); if (x($ret, 'src') && x($ret, 'filesize')) { $src = $ret['src']; @@ -808,7 +809,7 @@ function photos_post(App $a) } @unlink($src); $foo = 0; - call_hooks('photo_post_end', $foo); + Addon::callHooks('photo_post_end', $foo); return; } @@ -824,7 +825,7 @@ function photos_post(App $a) notice(t('Image exceeds size limit of %s', formatBytes($maximagesize)) . EOL); @unlink($src); $foo = 0; - call_hooks('photo_post_end', $foo); + Addon::callHooks('photo_post_end', $foo); return; } @@ -832,7 +833,7 @@ function photos_post(App $a) notice(t('Image file is empty.') . EOL); @unlink($src); $foo = 0; - call_hooks('photo_post_end', $foo); + Addon::callHooks('photo_post_end', $foo); return; } @@ -847,7 +848,7 @@ function photos_post(App $a) notice(t('Unable to process image.') . EOL); @unlink($src); $foo = 0; - call_hooks('photo_post_end',$foo); + Addon::callHooks('photo_post_end',$foo); killme(); } @@ -937,7 +938,7 @@ function photos_post(App $a) Worker::add(PRIORITY_HIGH, "Notifier", 'wall-new', $item_id); } - call_hooks('photo_post_end', intval($item_id)); + Addon::callHooks('photo_post_end', intval($item_id)); // addon uploaders should call "killme()" [e.g. exit] within the photo_post_end hook // if they do not wish to be redirected @@ -1103,7 +1104,7 @@ function photos_content(App $a) 'addon_text' => $uploader, 'default_upload' => true]; - call_hooks('photo_upload_form',$ret); + Addon::callHooks('photo_upload_form',$ret); $default_upload_box = replace_macros(get_markup_template('photos_default_uploader_box.tpl'), []); $default_upload_submit = replace_macros(get_markup_template('photos_default_uploader_submit.tpl'), [ diff --git a/mod/ping.php b/mod/ping.php index 9dd6780d01..6e11e18cd6 100644 --- a/mod/ping.php +++ b/mod/ping.php @@ -5,6 +5,7 @@ use Friendica\App; use Friendica\Content\Feature; use Friendica\Content\ForumManager; +use Friendica\Core\Addon; use Friendica\Core\Cache; use Friendica\Core\System; use Friendica\Core\PConfig; @@ -138,7 +139,7 @@ function ping_init(App $a) if (DBM::is_result($items_unseen)) { $arr = ['items' => $items_unseen]; - call_hooks('network_ping', $arr); + Addon::callHooks('network_ping', $arr); foreach ($items_unseen as $item) { if ($item['wall']) { diff --git a/mod/poke.php b/mod/poke.php index a8410b17d2..48eeec85a2 100644 --- a/mod/poke.php +++ b/mod/poke.php @@ -7,7 +7,7 @@ * If the required arguments aren't present, we'll display a simple form to choose a recipient and a verb. * parent is a special argument which let's you attach this activity as a comment to an existing conversation, which * may have started with somebody else poking (etc.) somebody, but this isn't necessary. This can be used in the more pokes - * plugin version to have entire conversations where Alice poked Bob, Bob fingered Alice, Alice hugged Bob, etc. + * addon version to have entire conversations where Alice poked Bob, Bob fingered Alice, Alice hugged Bob, etc. * * private creates a private conversation with the recipient. Otherwise your profile's default post privacy is used. * @@ -15,6 +15,7 @@ */ use Friendica\App; +use Friendica\Core\Addon; use Friendica\Core\System; use Friendica\Core\Worker; use Friendica\Database\DBM; @@ -142,7 +143,7 @@ function poke_init(App $a) { } - call_hooks('post_local_end', $arr); + Addon::callHooks('post_local_end', $arr); Worker::add(PRIORITY_HIGH, "Notifier", "like", $post_id); diff --git a/mod/pretheme.php b/mod/pretheme.php index be92885b72..4989eb87b7 100644 --- a/mod/pretheme.php +++ b/mod/pretheme.php @@ -1,12 +1,13 @@ get_theme_screenshot($theme), 'desc' => $desc, 'version' => $version, 'credits' => $credits]); + echo json_encode(['img' => Theme::getScreenshot($theme), 'desc' => $desc, 'version' => $version, 'credits' => $credits]); } killme(); diff --git a/mod/profile.php b/mod/profile.php index 4b1d4d2a0a..081b5e3a85 100644 --- a/mod/profile.php +++ b/mod/profile.php @@ -5,6 +5,7 @@ use Friendica\App; use Friendica\Content\Widget; use Friendica\Content\Nav; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Core\PConfig; use Friendica\Core\System; @@ -180,7 +181,7 @@ function profile_content(App $a, $update = 0) if ($tab === 'profile') { $o .= Profile::getAdvanced($a); - call_hooks('profile_advanced', $o); + Addon::callHooks('profile_advanced', $o); return $o; } diff --git a/mod/profiles.php b/mod/profiles.php index 32ed24346f..4cb9533093 100644 --- a/mod/profiles.php +++ b/mod/profiles.php @@ -6,6 +6,7 @@ use Friendica\App; use Friendica\Content\ContactSelector; use Friendica\Content\Feature; use Friendica\Content\Nav; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Core\PConfig; use Friendica\Core\System; @@ -178,7 +179,7 @@ function profiles_post(App $a) { $namechanged = false; - call_hooks('profile_post', $_POST); + Addon::callHooks('profile_post', $_POST); if (($a->argc > 1) && ($a->argv[1] !== "new") && intval($a->argv[1])) { $orig = q("SELECT * FROM `profile` WHERE `id` = %d AND `uid` = %d LIMIT 1", @@ -743,7 +744,7 @@ function profiles_content(App $a) { ]); $arr = ['profile' => $r[0], 'entry' => $o]; - call_hooks('profile_edit', $arr); + Addon::callHooks('profile_edit', $arr); return $o; } else { diff --git a/mod/register.php b/mod/register.php index 56d4e59360..2bd09aca92 100644 --- a/mod/register.php +++ b/mod/register.php @@ -1,6 +1,7 @@ $_POST]; - call_hooks('register_post', $arr); + Addon::callHooks('register_post', $arr); $max_dailies = intval(Config::get('system', 'max_daily_registrations')); if ($max_dailies) { @@ -241,7 +242,7 @@ function register_content(App $a) $arr = ['template' => $tpl]; - call_hooks('register_form', $arr); + Addon::callHooks('register_form', $arr); $tpl = $arr['template']; diff --git a/mod/settings.php b/mod/settings.php index 572857a48b..a5a4d4ad50 100644 --- a/mod/settings.php +++ b/mod/settings.php @@ -5,6 +5,7 @@ use Friendica\App; use Friendica\Content\Feature; use Friendica\Content\Nav; +use Friendica\Core\Addon; use Friendica\Core\System; use Friendica\Core\Worker; use Friendica\Core\Config; @@ -76,7 +77,7 @@ function settings_init(App $a) ]; $tabs[] = [ - 'label' => t('Plugins'), + 'label' => t('Addons'), 'url' => 'settings/addon', 'selected' => (($a->argc > 1) && ($a->argv[1] === 'addon')?'active':''), 'accesskey' => 'l', @@ -169,23 +170,25 @@ function settings_post(App $a) icon='%s', uid=%d WHERE client_id='%s'", - dbesc($key), - dbesc($secret), - dbesc($name), - dbesc($redirect), - dbesc($icon), - local_user(), - dbesc($key)); + dbesc($key), + dbesc($secret), + dbesc($name), + dbesc($redirect), + dbesc($icon), + local_user(), + dbesc($key) + ); } else { q("INSERT INTO clients (client_id, pw, name, redirect_uri, icon, uid) VALUES ('%s', '%s', '%s', '%s', '%s',%d)", - dbesc($key), - dbesc($secret), - dbesc($name), - dbesc($redirect), - dbesc($icon), - local_user()); + dbesc($key), + dbesc($secret), + dbesc($name), + dbesc($redirect), + dbesc($icon), + local_user() + ); } } goaway(System::baseUrl(true)."/settings/oauth/"); @@ -195,12 +198,12 @@ function settings_post(App $a) if (($a->argc > 1) && ($a->argv[1] == 'addon')) { check_form_security_token_redirectOnErr('/settings/addon', 'settings_addon'); - call_hooks('plugin_settings_post', $_POST); + Addon::callHooks('addon_settings_post', $_POST); return; } - if (($a->argc > 1) && ($a->argv[1] == 'connectors')) { - + if (($a->argc > 1) && ($a->argv[1] == 'connectors')) + { check_form_security_token_redirectOnErr('/settings/connectors', 'settings_connectors'); if (x($_POST, 'general-submit')) { @@ -277,7 +280,7 @@ function settings_post(App $a) } } - call_hooks('connector_settings_post', $_POST); + Addon::callHooks('connector_settings_post', $_POST); return; } @@ -351,7 +354,7 @@ function settings_post(App $a) intval(local_user()) ); - call_hooks('display_settings_post', $_POST); + Addon::callHooks('display_settings_post', $_POST); goaway('settings/display'); return; // NOTREACHED } @@ -364,7 +367,7 @@ function settings_post(App $a) goaway('settings'); } - call_hooks('settings_post', $_POST); + Addon::callHooks('settings_post', $_POST); if (x($_POST, 'password') || x($_POST, 'confirm')) { $newpass = $_POST['password']; @@ -748,18 +751,18 @@ function settings_content(App $a) if (($a->argc > 1) && ($a->argv[1] === 'addon')) { $settings_addons = ""; - $r = q("SELECT * FROM `hook` WHERE `hook` = 'plugin_settings' "); + $r = q("SELECT * FROM `hook` WHERE `hook` = 'addon_settings' "); if (!DBM::is_result($r)) { - $settings_addons = t('No Plugin settings configured'); + $settings_addons = t('No Addon settings configured'); } - call_hooks('plugin_settings', $settings_addons); + Addon::callHooks('addon_settings', $settings_addons); $tpl = get_markup_template('settings/addons.tpl'); $o .= replace_macros($tpl, [ '$form_security_token' => get_form_security_token("settings_addon"), - '$title' => t('Plugin Settings'), + '$title' => t('Addon Settings'), '$settings_addons' => $settings_addons ]); return $o; @@ -799,7 +802,7 @@ function settings_content(App $a) } $settings_connectors = ''; - call_hooks('connector_settings', $settings_connectors); + Addon::callHooks('connector_settings', $settings_connectors); if (is_site_admin()) { $diasp_enabled = t('Built-in support for %s connectivity is %s', t('Diaspora'), ((Config::get('system', 'diaspora_enabled')) ? t('enabled') : t('disabled'))); @@ -871,7 +874,7 @@ function settings_content(App $a) '$submit' => t('Save Settings'), ]); - call_hooks('display_settings', $o); + Addon::callHooks('display_settings', $o); return $o; } @@ -1284,7 +1287,7 @@ function settings_content(App $a) ]); - call_hooks('settings_form', $o); + Addon::callHooks('settings_form', $o); $o .= '' . "\r\n"; diff --git a/mod/statistics_json.php b/mod/statistics_json.php index 21eb10ab48..f2c6e074f9 100644 --- a/mod/statistics_json.php +++ b/mod/statistics_json.php @@ -5,10 +5,9 @@ */ use Friendica\App; +use Friendica\Core\Addon; use Friendica\Core\Config; -require_once("include/plugin.php"); - function statistics_json_init(App $a) { if (!Config::get("system", "nodeinfo")) { @@ -28,19 +27,19 @@ function statistics_json_init(App $a) { ]; $statistics["services"] = []; - $statistics["services"]["appnet"] = plugin_enabled("appnet"); - $statistics["services"]["blogger"] = plugin_enabled("blogger"); - $statistics["services"]["buffer"] = plugin_enabled("buffer"); - $statistics["services"]["dreamwidth"] = plugin_enabled("dwpost"); - $statistics["services"]["facebook"] = plugin_enabled("fbpost"); - $statistics["services"]["gnusocial"] = plugin_enabled("statusnet"); - $statistics["services"]["googleplus"] = plugin_enabled("gpluspost"); - $statistics["services"]["libertree"] = plugin_enabled("libertree"); - $statistics["services"]["livejournal"] = plugin_enabled("ljpost"); - $statistics["services"]["pumpio"] = plugin_enabled("pumpio"); - $statistics["services"]["twitter"] = plugin_enabled("twitter"); - $statistics["services"]["tumblr"] = plugin_enabled("tumblr"); - $statistics["services"]["wordpress"] = plugin_enabled("wppost"); + $statistics["services"]["appnet"] = Addon::isEnabled("appnet"); + $statistics["services"]["blogger"] = Addon::isEnabled("blogger"); + $statistics["services"]["buffer"] = Addon::isEnabled("buffer"); + $statistics["services"]["dreamwidth"] = Addon::isEnabled("dwpost"); + $statistics["services"]["facebook"] = Addon::isEnabled("fbpost"); + $statistics["services"]["gnusocial"] = Addon::isEnabled("statusnet"); + $statistics["services"]["googleplus"] = Addon::isEnabled("gpluspost"); + $statistics["services"]["libertree"] = Addon::isEnabled("libertree"); + $statistics["services"]["livejournal"] = Addon::isEnabled("ljpost"); + $statistics["services"]["pumpio"] = Addon::isEnabled("pumpio"); + $statistics["services"]["twitter"] = Addon::isEnabled("twitter"); + $statistics["services"]["tumblr"] = Addon::isEnabled("tumblr"); + $statistics["services"]["wordpress"] = Addon::isEnabled("wppost"); $statistics["appnet"] = $statistics["services"]["appnet"]; $statistics["blogger"] = $statistics["services"]["blogger"]; diff --git a/mod/subthread.php b/mod/subthread.php index 037e2982e7..af7f0b4921 100644 --- a/mod/subthread.php +++ b/mod/subthread.php @@ -1,6 +1,7 @@ $r, 'xml' => $o]; - call_hooks('personal_xrd', $arr); + Addon::callHooks('personal_xrd', $arr); echo $arr['xml']; killme(); diff --git a/scripts/worker.php b/scripts/worker.php index ccf24b7b43..a821fc1abe 100755 --- a/scripts/worker.php +++ b/scripts/worker.php @@ -6,6 +6,7 @@ */ use Friendica\App; +use Friendica\Core\Addon; use Friendica\Core\Config; use Friendica\Core\Worker; @@ -42,7 +43,7 @@ if (Config::get('system', 'maintenance', true)) { $a->set_baseurl(Config::get('system', 'url')); -load_hooks(); +Addon::loadHooks(); $spawn = (($_SERVER["argc"] == 2) && ($_SERVER["argv"][1] == "spawn")); diff --git a/src/App.php b/src/App.php index ae914ba605..2a134a9c17 100644 --- a/src/App.php +++ b/src/App.php @@ -56,8 +56,8 @@ class App public $hooks; public $timezone; public $interactive = true; - public $plugins; - public $plugins_admin = []; + public $addons; + public $addons_admin = []; public $apps = []; public $identities; public $is_mobile = false; diff --git a/src/Content/ContactSelector.php b/src/Content/ContactSelector.php index 4eb2e74aa2..fcaafb898c 100644 --- a/src/Content/ContactSelector.php +++ b/src/Content/ContactSelector.php @@ -4,6 +4,7 @@ */ namespace Friendica\Content; +use Friendica\Core\Addon; use Friendica\Database\DBM; use Friendica\Protocol\Diaspora; use dba; @@ -93,7 +94,7 @@ class ContactSelector NETWORK_APPNET => t('App.net') ]; - call_hooks('network_to_name', $nets); + Addon::callHooks('network_to_name', $nets); $search = array_keys($nets); $replace = array_values($nets); @@ -122,7 +123,7 @@ class ContactSelector $o = ''; $select = ['', t('Male'), t('Female'), t('Currently Male'), t('Currently Female'), t('Mostly Male'), t('Mostly Female'), t('Transgender'), t('Intersex'), t('Transsexual'), t('Hermaphrodite'), t('Neuter'), t('Non-specific'), t('Other'), t('Undecided')]; - call_hooks('gender_selector', $select); + Addon::callHooks('gender_selector', $select); $o .= ""; foreach ($select as $selection) { @@ -166,7 +167,7 @@ class ContactSelector $o = ''; $select = ['', t('Single'), t('Lonely'), t('Available'), t('Unavailable'), t('Has crush'), t('Infatuated'), t('Dating'), t('Unfaithful'), t('Sex Addict'), t('Friends'), t('Friends/Benefits'), t('Casual'), t('Engaged'), t('Married'), t('Imaginarily married'), t('Partners'), t('Cohabiting'), t('Common law'), t('Happy'), t('Not looking'), t('Swinger'), t('Betrayed'), t('Separated'), t('Unstable'), t('Divorced'), t('Imaginarily divorced'), t('Widowed'), t('Uncertain'), t('It\'s complicated'), t('Don\'t care'), t('Ask me')]; - call_hooks('marital_selector', $select); + Addon::callHooks('marital_selector', $select); $o .= '