Browse Source

Update docs

changelog, install and doc folder
Adam Magness 1 year ago
parent
commit
20a16b0b35

+ 2
- 2
CHANGELOG View File

@@ -299,7 +299,7 @@ Version 3.4.3 (2015-12-22)
299 299
 	Contact's posts are shown in a dedicated page (annando)
300 300
 	Module name is shown in page title to ease browser history navigation (issue #2079) (tobiasd)
301 301
   What's new for admins:
302
-	Forumlist functionality moved from plugin to core (rabuzarus, annando)
302
+	Forumlist functionality moved from addon to core (rabuzarus, annando)
303 303
 	Changes on poller/workers limits management (annando)
304 304
 	Diaspora and OStatus can be enabled only if requirements are satisfied (annando)
305 305
 	Support for additional passwords for ejabberd (annando)
@@ -380,7 +380,7 @@ Version 3.4.2 (2015-09-29)
380 380
 	Support for inline [code] tag usage (fabrixxm)
381 381
 	Fix login form in aside (issue #1348) (annando)
382 382
 	Show both url-style and webfinger-style identity address in profile (issue #1621) (tobiasd)
383
-	Add button to reload all active plugins in admin plugins page to ensure new hooks are used (fabrixxm)
383
+	Add button to reload all active addons in admin addons page to ensure new hooks are used (fabrixxm)
384 384
 	Make the hardcoded path to global directory configurable (annando)
385 385
 	Change default directory to dir.friendi.ca (annando)
386 386
 	Improve cache system with granular expire time (annando)

+ 6
- 6
INSTALL.txt View File

@@ -130,18 +130,18 @@ You should also be sure that $a->config['php_path'] is set correctly, it should
130 130
 look like (changing it to the correct PHP location)
131 131
 
132 132
 $a->config['php_path'] = '/usr/local/php53/bin/php'
133
-
134
-Alternative: You may be able to use the 'poormancron' plugin to perform this
133
+  
134
+Alternative: You may be able to use the 'poormancron' addon to perform this
135 135
 step if you are using a recent Friendica release. 'poormancron' may result in
136 136
 perfomance and memory issues and is only suitable for small sites with one or
137
-two users and a handful of contacts. To do this, edit the file
138
-".htconfig.php" and look for a line describing your plugins. On a fresh
137
+two users and a handful of contacts. To do this, edit the file 
138
+".htconfig.php" and look for a line describing your addons. On a fresh 
139 139
 installation, it will look like
140 140
 
141 141
 $a->config['system']['addon'] = 'js_upload';
142 142
 
143
-This indicates the "js_upload" addon module is enabled. You may add additional
144
-addons/plugins using this same line in the configuration file. Change it to
143
+This indicates the "js_upload" addon module is enabled. You may add additional 
144
+addons/addons using this same line in the configuration file. Change it to 
145 145
 read
146 146
 
147 147
 $a->config['system']['addon'] = 'js_upload,poormancron';

+ 1
- 1
README.md View File

@@ -9,7 +9,7 @@ Our mission is to free friends, family and colleagues from data-harvesting corpo
9 9
 
10 10
 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.
11 11
 
12
-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.
12
+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.
13 13
 
14 14
 Join today and [get your Friendica profile!](https://dir.friendica.social/servers 'Join Friendica today!')
15 15
 

+ 1
- 1
doc/Accesskeys.md View File

@@ -69,7 +69,7 @@ General
69 69
 * o: Account
70 70
 * t: Additional features
71 71
 * w: Social Networks
72
-* l: Plugins
72
+* l: Addons
73 73
 * d: Delegations
74 74
 * b: Connected apps
75 75
 * e: Export personal data

+ 8
- 8
doc/Chats.md View File

@@ -8,10 +8,10 @@ There are two possibilities to use chat on your friendica site
8 8
 * IRC Chat
9 9
 * Jappix
10 10
 
11
-IRC-Chat Plugin
11
+IRC-Chat Addon
12 12
 ---
13 13
 
14
-After activating the plugin, you can find the chat at [yoursite.com/irc](../irc).
14
+After activating the addon, you can find the chat at [yoursite.com/irc](../irc).
15 15
 Note: you can use this chat without any login at your site so that everyone could use it.
16 16
 
17 17
 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.
28 28
 Jappix Mini
29 29
 ---
30 30
 
31
-The Jappix Mini Plugin creates a chatbox for jabber- and XMPP-contacts.
32
-You should already have a jabber/XMPP-account before setting up the plugin.
31
+The Jappix Mini Addon creates a chatbox for jabber- and XMPP-contacts.
32
+You should already have a jabber/XMPP-account before setting up the addon.
33 33
 You can find more information at [jabber.org](http://www.jabber.org/).
34 34
 
35 35
 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
48 48
 Just unpack the file and rename the directory to „jappixmini“.
49 49
 Next, upload this directory and the .tgz-file into your addon directory of your friendica installation.
50 50
 
51
-Now you can activate the plugin globally on the admin pages.
52
-In the plugin sidebar, you will find an entry of jappix now (where you can also find twitter, GNU Social and others).
53
-The following page shows the settings of this plugin.
51
+Now you can activate the addon globally on the admin pages.
52
+In the addon sidebar, you will find an entry of jappix now (where you can also find twitter, GNU Social and others).
53
+The following page shows the settings of this addon.
54 54
 
55 55
 Activate the BOSH proxy.
56 56
 
57 57
 ###2. Settings
58 58
 
59
-Go to your user account settings next and choose the plugin page.
59
+Go to your user account settings next and choose the addon page.
60 60
 Scroll down until you find the Jappix Mini addon settings.
61 61
 
62 62
 At first you have to activate the addon.

+ 1
- 1
doc/Composer.md View File

@@ -55,7 +55,7 @@ If you don't need to use any third-party library, then you don't need to use Com
55 55
 
56 56
 #### Adding a third-party library to Friendica
57 57
 
58
-Does your shiny new [Plugin](help/Plugins) need to rely on a third-party library not required by Friendica yet?
58
+Does your shiny new [Addon](help/Addons) need to rely on a third-party library not required by Friendica yet?
59 59
 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`.
60 60
 
61 61
 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.

+ 1
- 1
doc/FAQ.md View File

@@ -87,7 +87,7 @@ Blocked contacts cannot do this. They cannot communicate with you directly, only
87 87
 However we do not import their posts or private messages to you.
88 88
 Like blocking, you will still see this person's comments to posts made by your friends.
89 89
 
90
-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.
90
+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.
91 91
 
92 92
 An **archived contact** means that communication is not possible and will not be attempted.
93 93
 (Perhaps the person moved to a new site and removed the old profile.)

+ 1
- 1
doc/Home.md View File

@@ -43,7 +43,7 @@ Friendica Documentation and Resources
43 43
 	* [Help on Vagrant](help/Vagrant)
44 44
 	* [Bugs and Issues](help/Bugs-and-Issues)
45 45
 * Code structure
46
-	* [Plugin Development](help/Plugins)
46
+	* [Addon Development](help/Addons)
47 47
 	* [Theme Development](help/themes)
48 48
 	* [Smarty 3 Templates](help/smarty3-templates)
49 49
 * How To

+ 3
- 3
doc/Improve-Performance.md View File

@@ -22,16 +22,16 @@ If you have many OStatus contacts then completing of conversations can take some
22 22
 
23 23
 When using MyISAM (default) or InnoDB on MariaDB 10 this speeds up search.
24 24
 
25
-Plugins
25
+Addons
26 26
 --------
27 27
 
28
-Active the following plugins:
28
+Active the following addons:
29 29
 
30 30
     rendertime
31 31
 
32 32
 ###rendertime
33 33
 
34
-This plugin doesn't speed up your system. 
34
+This addon doesn't speed up your system. 
35 35
 It helps to analyze your bottlenecks.
36 36
 
37 37
 When enabled you see some values at the bottom of every page.

+ 9
- 9
doc/Installing-Connectors.md View File

@@ -4,28 +4,28 @@ Installing Connectors (Twitter/GNU Social)
4 4
 * [Home](help)
5 5
 
6 6
 
7
-Friendica uses plugins to provide connectivity to some networks, such as Twitter or App.net. 
7
+Friendica uses addons to provide connectivity to some networks, such as Twitter or App.net. 
8 8
 
9
-There is also a plugin to post through to an existing account on a GNU Social service.
9
+There is also a addon to post through to an existing account on a GNU Social service.
10 10
 You only need this to post to an already existing GNU Social account, but not to communicate with GNU Social members in general.
11 11
 
12
-All three plugins require an account on the target network.
12
+All three addons require an account on the target network.
13 13
 In addition you (or typically the server administrator) will need to obtain an API key to provide authenticated access to your Friendica server.
14 14
 
15 15
 Site Configuration
16 16
 ---
17 17
 
18
-Plugins must be installed by the site administrator before they can be used.
18
+Addons must be installed by the site administrator before they can be used.
19 19
 This is accomplished through the site administration panel.
20 20
 
21 21
 Each of the connectors also requires an "API key" from the service you wish to connect with.
22
-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).
22
+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).
23 23
 The ways to obtain these keys vary between the services, but they all require an existing account on the target service.
24 24
 Once installed, these API keys can usually be shared by all site members.
25 25
 
26
-The details of configuring each service follow (much of this information comes directly from the plugin source files):
26
+The details of configuring each service follow (much of this information comes directly from the addon source files):
27 27
 
28
-Twitter Plugin for Friendica
28
+Twitter Addon for Friendica
29 29
 ---
30 30
 
31 31
 * Author: Tobias Diekershoff
@@ -33,7 +33,7 @@ Twitter Plugin for Friendica
33 33
 * License: 3-clause BSD license
34 34
 
35 35
 ###Configuration
36
-To use this plugin you need a OAuth Consumer key pair (key & secret).
36
+To use this addon you need a OAuth Consumer key pair (key & secret).
37 37
 You can get it from [Twitter](https://twitter.com/apps).
38 38
 
39 39
 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
51 51
 Find the author's documentation here: [http://diekershoff.homeunix.net/redmine/wiki/friendikaplugin/Twitter_Plugin](http://diekershoff.homeunix.net/redmine/wiki/friendikaplugin/Twitter_Plugin)
52 52
 
53 53
 
54
-GNU Social Plugin for Friendica
54
+GNU Social Addon for Friendica
55 55
 ---
56 56
 
57 57
 * Author: Tobias Diekershoff

+ 29
- 33
doc/Plugins.md View File

@@ -1,4 +1,4 @@
1
-Friendica Addon/Plugin development
1
+Friendica Addon development
2 2
 ==============
3 3
 
4 4
 * [Home](help)
@@ -7,32 +7,32 @@ Please see the sample addon 'randplace' for a working example of using some of t
7 7
 Addons work by intercepting event hooks - which must be registered.
8 8
 Modules work by intercepting specific page requests (by URL path).
9 9
 
10
-Plugin names cannot contain spaces or other punctuation and are used as filenames and function names.
10
+Addon names cannot contain spaces or other punctuation and are used as filenames and function names.
11 11
 You may supply a "friendly" name within the comment block.
12
-Each addon must contain both an install and an uninstall function based on the addon/plugin name.
13
-For instance "plugin1name_install()".
14
-These two functions take no arguments and are usually responsible for registering (and unregistering) event hooks that your plugin will require.
15
-The install and uninstall functions will also be called (i.e. re-installed) if the plugin changes after installation.
12
+Each addon must contain both an install and an uninstall function based on the addon/addon name.
13
+For instance "addon1name_install()".
14
+These two functions take no arguments and are usually responsible for registering (and unregistering) event hooks that your addon will require.
15
+The install and uninstall functions will also be called (i.e. re-installed) if the addon changes after installation.
16 16
 Therefore your uninstall should not destroy data and install should consider that data may already exist.
17 17
 Future extensions may provide for "setup" amd "remove".
18 18
 
19
-Plugins should contain a comment block with the four following parameters:
19
+Addons should contain a comment block with the four following parameters:
20 20
 
21 21
     /*
22
-     * Name: My Great Plugin
23
-     * Description: This is what my plugin does. It's really cool.
22
+     * Name: My Great Addon
23
+     * Description: This is what my addon does. It's really cool.
24 24
      * Version: 1.0
25 25
      * Author: John Q. Public <john@myfriendicasite.com>
26 26
      */
27 27
 
28
-Register your plugin hooks during installation.
28
+Register your addon hooks during installation.
29 29
 
30 30
     Addon::registerHook($hookname, $file, $function);
31 31
 
32 32
 $hookname is a string and corresponds to a known Friendica hook.
33 33
 
34 34
 $file is a pathname relative to the top-level Friendica directory.
35
-This *should* be 'addon/plugin_name/plugin_name.php' in most cases.
35
+This *should* be 'addon/addon_name/addon_name.php' in most cases.
36 36
 
37 37
 $function is a string and is the name of the function which will be executed when the hook is called.
38 38
 
@@ -69,39 +69,39 @@ Remember to declare it with '&' if you wish to alter it.
69 69
 Modules
70 70
 ---
71 71
 
72
-Plugins/addons may also act as "modules" and intercept all page requests for a given URL path.
73
-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.
72
+Addons/addons may also act as "modules" and intercept all page requests for a given URL path.
73
+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.
74 74
 
75
-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.
75
+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.
76 76
 These are parsed into an array $a->argv, with a corresponding $a->argc indicating the number of URL components.
77
-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).
77
+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).
78 78
 This will include:
79 79
 
80 80
     $a->argc = 3
81
-    $a->argv = array(0 => 'plugin', 1 => 'arg1', 2 => 'arg2');
81
+    $a->argv = array(0 => 'addon', 1 => 'arg1', 2 => 'arg2');
82 82
 
83
-Your module functions will often contain the function plugin_name_content(App $a), which defines and returns the page body content.
84
-They may also contain plugin_name_post(App $a) which is called before the _content function and typically handles the results of POST forms.
85
-You may also have plugin_name_init(App $a) which is called very early on and often does module initialisation.
83
+Your module functions will often contain the function addon_name_content(App $a), which defines and returns the page body content.
84
+They may also contain addon_name_post(App $a) which is called before the _content function and typically handles the results of POST forms.
85
+You may also have addon_name_init(App $a) which is called very early on and often does module initialisation.
86 86
 
87 87
 Templates
88 88
 ---
89 89
 
90
-If your plugin needs some template, you can use the Friendica template system.
90
+If your addon needs some template, you can use the Friendica template system.
91 91
 Friendica uses [smarty3](http://www.smarty.net/) as a template engine.
92 92
 
93
-Put your tpl files in the *templates/* subfolder of your plugin.
93
+Put your tpl files in the *templates/* subfolder of your addon.
94 94
 
95
-In your code, like in the function plugin_name_content(), load the template file and execute it passing needed values:
95
+In your code, like in the function addon_name_content(), load the template file and execute it passing needed values:
96 96
 
97 97
     # load template file. first argument is the template name,
98
-    # second is the plugin path relative to friendica top folder
99
-    $tpl = get_markup_template('mytemplate.tpl', 'addon/plugin_name/');
98
+    # second is the addon path relative to friendica top folder
99
+    $tpl = get_markup_template('mytemplate.tpl', 'addon/addon_name/');
100 100
 
101 101
     # apply template. first argument is the loaded template,
102 102
     # second an array of 'name'=>'values' to pass to template
103 103
     $output = replace_macros($tpl,array(
104
-        'title' => 'My beautiful plugin',
104
+        'title' => 'My beautiful addon',
105 105
     ));
106 106
 
107 107
 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:
151 151
 * called when the Settings pages are submitted
152 152
 * $b is the $_POST array
153 153
 
154
-### 'plugin_settings'
154
+### 'addon_settings'
155 155
 * called when generating the HTML for the addon settings page
156 156
 * $b is the (string) HTML of the addon settings page before the final '</form>' tag.
157 157
 
158
-### 'plugin_settings_post'
158
+### 'addon_settings_post'
159 159
 * called when the Addon Settings pages are submitted
160 160
 * $b is the $_POST array
161 161
 
@@ -394,10 +394,6 @@ include/conversation.php:	Addon::callHooks('jot_tool', $jotplugins);
394 394
 
395 395
 include/conversation.php:	Addon::callHooks('jot_networks', $jotnets);
396 396
 
397
-include/plugin.php:if(! function_exists('call_hooks')) {
398
-
399
-include/plugin.php:function Addon::callHooks($name, &$data = null) {
400
-
401 397
 index.php:	Addon::callHooks('init_1');
402 398
 
403 399
 index.php:Addon::callHooks('app_menu', $arr);
@@ -434,13 +430,13 @@ mod/contacts.php:	Addon::callHooks('contact_edit_post', $_POST);
434 430
 
435 431
 mod/contacts.php:		Addon::callHooks('contact_edit', $arr);
436 432
 
437
-mod/settings.php:		Addon::callHooks('plugin_settings_post', $_POST);
433
+mod/settings.php:		Addon::callHooks('addon_settings_post', $_POST);
438 434
 
439 435
 mod/settings.php:		Addon::callHooks('connector_settings_post', $_POST);
440 436
 
441 437
 mod/settings.php:	Addon::callHooks('settings_post', $_POST);
442 438
 
443
-mod/settings.php:		Addon::callHooks('plugin_settings', $settings_addons);
439
+mod/settings.php:		Addon::callHooks('addon_settings', $settings_addons);
444 440
 
445 441
 mod/settings.php:		Addon::callHooks('connector_settings', $settings_connectors);
446 442
 

+ 5
- 5
doc/Settings.md View File

@@ -14,7 +14,7 @@ These worker tasks are prioritised and are done accordingly.
14 14
 
15 15
 Then you get an overview of the accounts on your node, which can be moderated in the "Users" section of the panel.
16 16
 As well as an overview of the currently active addons
17
-The list is linked, so you can have quick access to the plugin settings.
17
+The list is linked, so you can have quick access to the Addon settings.
18 18
 And finally you are informed about the version of Friendica you have installed.
19 19
 If you contact the devs with a bug or problem, please also mention the version of your node.
20 20
 
@@ -205,7 +205,7 @@ Here the admin can also block/unblock users from accessing the node or delete th
205 205
 In the last section of the page admins can create new accounts on the node.
206 206
 The password for the new account will be send by email to the choosen email address.
207 207
 
208
-## Plugins
208
+## Addons
209 209
 
210 210
 This page is for selecting and configuration of extensions for Friendica which have to be placed into the `/addon` subdirectory of your Friendica installation.
211 211
 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
213 213
 Also shown is the version of the addon and an indicator if the addon is currently active or not.
214 214
 
215 215
 When you update your node and the addons they may have to be reloaded.
216
-To simplify this process there is a button at the top of the page to reload all active plugins.
216
+To simplify this process there is a button at the top of the page to reload all active Addons.
217 217
 
218 218
 ## Themes
219 219
 
220
-The Themes section of the admin panel works similar to the Plugins section but let you control the themes on your Friendica node.
220
+The Themes section of the admin panel works similar to the Addons section but let you control the themes on your Friendica node.
221 221
 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.
222 222
 Should the theme offer special settings, admins can set a global default value here.
223 223
 
@@ -266,7 +266,7 @@ To do so, they need to know the GUID of the posting.
266 266
 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.
267 267
 You can get to the `/display` page by following the *Link to source*.
268 268
 
269
-## Plugin Features
269
+## Addon Features
270 270
 
271 271
 Some of the addons you can install for your Friendica node have settings which have to be set by the admin.
272 272
 All those addons will be listed in this area of the admin panels side bar with their names.

+ 2
- 2
doc/database.md View File

@@ -5,7 +5,7 @@ Database Tables
5 5
 
6 6
 | Table                                                | Description                                      |
7 7
 |------------------------------------------------------|--------------------------------------------------|
8
-| [addon](help/database/db_addon)                      | registered plugins                               |
8
+| [addon](help/database/db_addon)                      | registered addons                               |
9 9
 | [attach](help/database/db_attach)                    | file attachments                                 |
10 10
 | [auth_codes](help/database/db_auth_codes)            | OAuth usage                                      |
11 11
 | [cache](help/database/db_cache)                      | OEmbed cache                                     |
@@ -24,7 +24,7 @@ Database Tables
24 24
 | [group](help/database/db_group)                      | privacy groups, group info                       |
25 25
 | [group_member](help/database/db_group_member)        | privacy groups, member info                      |
26 26
 | [gserver](help/database/db_gserver)                  |                                                  |
27
-| [hook](help/database/db_hook)                        | plugin hook registry                             |
27
+| [hook](help/database/db_hook)                        | addon hook registry                             |
28 28
 | [intro](help/database/db_intro)                      |                                                  |
29 29
 | [item](help/database/db_item)                        | all posts                                        |
30 30
 | [locks](help/database/db_locks)                      |                                                  |

+ 2
- 2
doc/database/db_addon.md View File

@@ -4,7 +4,7 @@ Table addon
4 4
 | Field         | Description                                   | Type       | Null | Key | Default | Extra           |
5 5
 | ------------- | --------------------------------------------- | ---------- | ---- | --- | ------- | --------------- |
6 6
 | id            |                                               | int(11)    | NO   | PRI | NULL    | auto_increment  |
7
-| name          | plugin base (file)name                        | char(255)  | NO   |     |         |                 |
7
+| name          | addon base (file)name                        | char(255)  | NO   |     |         |                 |
8 8
 | version       | currently unused                              | char(255)  | NO   |     |         |                 |
9 9
 | installed     | currently always 1                            | tinyint(1) | NO   |     | 0       |                 |
10 10
 | hidden        | currently unused                              | tinyint(1) | NO   |     | 0       |                 |
@@ -12,6 +12,6 @@ Table addon
12 12
 | plugin_admin  | 1 = has admin config, 0 = has no admin config | tinyint(1) | NO   |     | 0       |                 |
13 13
 
14 14
 Notes:
15
-These are addons which have been enabled by the site administrator on the admin/plugin page
15
+These are addons which have been enabled by the site administrator on the admin/addon page
16 16
 
17 17
 Return to [database documentation](help/database)

+ 6
- 6
doc/de/Chats.md View File

@@ -8,9 +8,9 @@ Du hast derzeit zwei Möglichkeiten, einen Chat auf Deiner Friendica-Seite zu be
8 8
 * IRC - Internet Relay Chat
9 9
 * Jappix
10 10
 
11
-##IRC Plugin
11
+##IRC Addon
12 12
 
13
-Sobald das Plugin aktiviert ist, kannst Du den Chat unter [deineSeite.de/irc](../irc) finden.
13
+Sobald das Addon aktiviert ist, kannst Du den Chat unter [deineSeite.de/irc](../irc) finden.
14 14
 Beachte aber, dass dieser Chat auch ohne Anmeldung auf Deiner Seite zugänglich ist und somit auch Fremde diesen Chat mitnutzen können.
15 15
 
16 16
 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 <a href="http://wiki.ubu
29 29
 
30 30
 ##Jappix Mini
31 31
 
32
-Das Jappix Mini Plugin erlaubt das Erstellen einer Chatbox für Jabber/XMPP-Kontakte.
32
+Das Jappix Mini Addon erlaubt das Erstellen einer Chatbox für Jabber/XMPP-Kontakte.
33 33
 Ein Jabber/XMPP Account sollte vor der Installation bereits vorhanden sein.
34 34
 Die ausführliche Anleitung dazu und eine Kontrolle, ob Du nicht sogar schon über Deinen E-Mail Anbieter einen Jabber-Account hast, findest Du unter <a href="http://einfachjabber.de" target="_blank">einfachjabber.de</a>.
35 35
 
@@ -53,15 +53,15 @@ oder als normaler Download von hier: https://github.com/friendica/friendica-addo
53 53
 
54 54
 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.
55 55
 
56
-Nach dem Upload gehts in den Friendica Adminbereich und dort zu den Plugins.
57
-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.
56
+Nach dem Upload gehts in den Friendica Adminbereich und dort zu den Addons.
57
+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.
58 58
 
59 59
 Setze hier den Haken zur Aktivierung des BOSH Proxys.
60 60
 Weiter gehts in den Einstellungen Deines Friendica Accounts.
61 61
 
62 62
 2. Einstellungen
63 63
 
64
-Gehe bitte zu den Plugin-Einstellungen in Deinen Konto-Einstellungen (Account Settings).
64
+Gehe bitte zu den Addon-Einstellungen in Deinen Konto-Einstellungen (Account Settings).
65 65
 Scrolle ein Stück hinunter bis zu den Jappix Mini Addon settings.
66 66
 
67 67
 Aktiviere hier zuerst das Addon.

+ 1
- 1
doc/de/FAQ.md View File

@@ -104,7 +104,7 @@ Ignorierte Kontakte können weiterhin Beiträge und private Nachrichten von Dir
104 104
 Deren Beiträge und private Nachrichten werden allerdings nicht importiert. 
105 105
 Wie bei blockierten Beiträgen siehst Du auch hier weiterhin die Kommentare dieser Person zu anderen Beiträgen Deiner Freunde. 
106 106
 
107
-[Ein Plugin namens "blockem" kann installiert werden, um alle Beiträge einer bestimmten Person in Deinem Stream zu verstecken bzw. zu verkürzen. 
107
+[Ein Erweiterung namens "blockem" kann installiert werden, um alle Beiträge einer bestimmten Person in Deinem Stream zu verstecken bzw. zu verkürzen. 
108 108
 Dabei werden auch Kommentare dieser Person in Beiträgen Deiner Freunde blockiert.]
109 109
 
110 110
 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). 

+ 2
- 2
doc/de/Home.md View File

@@ -30,7 +30,7 @@ Friendica - Dokumentation und Ressourcen
30 30
 * [Installation](help/Install)
31 31
 * [Update](help/Update) (EN)
32 32
 * [Konfigurationen & Admin-Panel](help/Settings)
33
-* [Plugins](help/Plugins)
33
+* [Addons](help/Addons)
34 34
 * [Konnektoren (Connectors) installieren (Twitter/GNU Social)](help/Installing-Connectors)
35 35
 * [Installation eines ejabberd Servers (XMPP-Chat) mit synchronisierten Anmeldedaten](help/install-ejabberd) (EN)
36 36
 * [Betreibe deine Seite mit einem SSL-Zertifikat](help/SSL)
@@ -45,7 +45,7 @@ Friendica - Dokumentation und Ressourcen
45 45
 * [Help on Vagrant](help/Vagrant)
46 46
 * [How to translate Friendica](help/translations) (EN)
47 47
 * [Bugs and Issues](help/Bugs-and-Issues)
48
-* [Plugin Development](help/Plugins)
48
+* [Addon Development](help/Addons)
49 49
 * [Theme Development](help/themes)
50 50
 * [Smarty 3 Templates](help/smarty3-templates)
51 51
 * [Protokoll Dokumentation](help/Protocol) (EN)

+ 3
- 3
doc/de/Improve-Performance.md View File

@@ -28,10 +28,10 @@ Der Nachteil: Du siehst nicht jede Antwort einer OStatus-Unterhaltung. Aus diese
28 28
 
29 29
 Wenn du MyISAM (Standardeinstellung) oder InnoDB mit MariaDB 10 nutzt, dann beschleunigt dies die Suche.
30 30
 
31
-Plugins
31
+Addons
32 32
 --------
33 33
 
34
-Aktiviere die folgenden Plugins:
34
+Aktiviere die folgenden Addons:
35 35
 
36 36
     rendertime
37 37
 
@@ -39,7 +39,7 @@ Aktiviere die folgenden Plugins:
39 39
 
40 40
 **Beschreibung**
41 41
 
42
-Dieses Plugin beschleunigt dein System nicht, aber es hilft dabei, die Flaschenhälse zu ermitteln.
42
+Dieses Addon beschleunigt dein System nicht, aber es hilft dabei, die Flaschenhälse zu ermitteln.
43 43
 
44 44
 Wenn es aktiviert ist, dann siehst du Werte wie die folgenden auf jeder deiner Seiten:
45 45
 

+ 10
- 10
doc/de/Installing-Connectors.md View File

@@ -3,29 +3,29 @@ Konnektoren installieren (Twitter/GNU Social)
3 3
 
4 4
 * [Zur Startseite der Hilfe](help)
5 5
 
6
-Friendica nutzt Plugins, um die Verbindung zu anderen Netzwerken wie Twitter oder App.net zu gewährleisten.
6
+Friendica nutzt Erweiterung, um die Verbindung zu anderen Netzwerken wie Twitter oder App.net zu gewährleisten.
7 7
 
8
-Es gibt außerdem ein Plugin, um über einen bestehenden GNU Social-Account diesen Service zu nutzen. 
9
-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. 
8
+Es gibt außerdem ein Erweiterung, um über einen bestehenden GNU Social-Account diesen Service zu nutzen. 
9
+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. 
10 10
 
11
-Alle drei Plugins benötigen einen Account im gewünschten Netzwerk. 
11
+Alle drei Erweiterung benötigen einen Account im gewünschten Netzwerk. 
12 12
 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.
13 13
 
14 14
 
15 15
 **Seitenkonfiguration**
16 16
 
17
-Plugins müssen vom Administrator installiert werden, bevor sie genutzt werden können. 
17
+Erweiterung müssen vom Administrator installiert werden, bevor sie genutzt werden können. 
18 18
 Dieses kann über das Administrationsmenü erstellt werden.
19 19
 
20 20
 Jeder der Konnektoren benötigt zudem einen API-Schlüssel vom Service, der verbunden werden soll. 
21
-Einige Plugins erlaube es, diese Informationen auf den Administrationsseiten einzustellen, wohingegen andere eine direkte Bearbeitung der Konfigurationsdatei ".htconfig.php" erfordern. 
21
+Einige Erweiterung erlaube es, diese Informationen auf den Administrationsseiten einzustellen, wohingegen andere eine direkte Bearbeitung der Konfigurationsdatei ".htconfig.php" erfordern. 
22 22
 Der Weg, um diese Schlüssel zu erhalten, variiert stark, jedoch brauchen fast alle einen bestehenden Account im gewünschten Service. 
23 23
 Einmal installiert, können diese Schlüssel von allen Seitennutzern genutzt werden.
24 24
 
25
-Im Folgenden findest du die Einstellungen für die verschiedenen Services (viele dieser Informationen kommen direkt aus den Quelldateien der Plugins):
25
+Im Folgenden findest du die Einstellungen für die verschiedenen Services (viele dieser Informationen kommen direkt aus den Quelldateien der Erweiterung):
26 26
 
27 27
 
28
-**Twitter Plugin für Friendica**
28
+**Twitter Erweiterung für Friendica**
29 29
 
30 30
 * Author: Tobias Diekershoff
31 31
 * tobias.diekershoff@gmx.net
@@ -33,7 +33,7 @@ Im Folgenden findest du die Einstellungen für die verschiedenen Services (viele
33 33
 * License:3-clause BSD license
34 34
 
35 35
 Konfiguration:
36
-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
36
+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
37 37
 
38 38
 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.
39 39
 
@@ -47,7 +47,7 @@ $a->config['twitter']['consumersecret'] = 'your consumer_secret here';
47 47
 Anschließend kann der Nutzer deiner Seite die Twitter-Einstellungen selbst eintragen: "Einstellungen -> Connector Einstellungen".
48 48
 
49 49
 
50
-**GNU Social Plugin für Friendica**
50
+**GNU Social Erweiterung für Friendica**
51 51
 
52 52
 * Author: Tobias Diekershoff
53 53
 * tobias.diekershoff@gmx.net

+ 22
- 26
doc/de/Plugins.md View File

@@ -1,4 +1,4 @@
1
-Friendica Addon/Plugin-Entwicklung
1
+Friendica Addon/Entwicklung
2 2
 ==============
3 3
 
4 4
 * [Zur Startseite der Hilfe](help)
@@ -8,30 +8,30 @@ Das Facebook-Addon bietet ein Beispiel dafür, die "addon"- und "module"-Funktio
8 8
 Addons arbeiten, indem sie Event Hooks abfangen.
9 9
 Module arbeiten, indem bestimmte Seitenanfragen (durch den URL-Pfad) abgefangen werden.
10 10
 
11
-Plugin-Namen können keine Leerstellen oder andere Interpunktionen enthalten und werden als Datei- und Funktionsnamen genutzt.
11
+Addon-Namen können keine Leerstellen oder andere Interpunktionen enthalten und werden als Datei- und Funktionsnamen genutzt.
12 12
 Du kannst einen lesbaren Namen im Kommentarblock eintragen.
13
-Jedes Addon muss beides beinhalten - eine Installations- und eine Deinstallationsfunktion, die auf dem Addon-/Plugin-Namen basieren; z.B. "plugin1name_install()".
14
-Diese beiden Funktionen haben keine Argumente und sind dafür verantwortlich, Event Hooks zu registrieren und abzumelden (unregistering), die dein Plugin benötigt.
15
-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.
13
+Jedes Addon muss beides beinhalten - eine Installations- und eine Deinstallationsfunktion, die auf dem Addon-Namen basieren; z.B. "addon1name_install()".
14
+Diese beiden Funktionen haben keine Argumente und sind dafür verantwortlich, Event Hooks zu registrieren und abzumelden (unregistering), die dein Addon benötigt.
15
+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.
16 16
 Zukünftige Extensions werden möglicherweise "Setup" und "Entfernen" anbieten.
17 17
 
18
-Plugins sollten einen Kommentarblock mit den folgenden vier Parametern enthalten:
18
+Addons sollten einen Kommentarblock mit den folgenden vier Parametern enthalten:
19 19
 
20 20
     /*
21
-     * Name: My Great Plugin
22
-     * Description: This is what my plugin does. It's really cool.
21
+     * Name: My Great Addon
22
+     * Description: This is what my addon does. It's really cool.
23 23
      * Version: 1.0
24 24
      * Author: John Q. Public <john@myfriendicasite.com>
25 25
      */
26 26
 
27
-Registriere deine Plugin-Hooks während der Installation.
27
+Registriere deine Addon-Hooks während der Installation.
28 28
 
29 29
     Addon::registerHook($hookname, $file, $function);
30 30
 
31 31
 $hookname ist ein String und entspricht einem bekannten Friendica-Hook.
32 32
 
33 33
 $file steht für den Pfadnamen, der relativ zum Top-Level-Friendicaverzeichnis liegt.
34
-Das *sollte* "addon/plugin_name/plugin_name.php' sein.
34
+Das *sollte* "addon/addon_name/addon_name.php' sein.
35 35
 
36 36
 $function ist ein String und der Name der Funktion, die ausgeführt wird, wenn der Hook aufgerufen wird.
37 37
 
@@ -57,19 +57,19 @@ Achte darauf, diese mit "&" zu deklarieren, wenn du sie bearbeiten willst.
57 57
 Module
58 58
 ---
59 59
 
60
-Plugins/Addons können auch als "Module" agieren und alle Seitenanfragen für eine bestimte URL abfangen.
61
-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.
60
+Addons können auch als "Module" agieren und alle Seitenanfragen für eine bestimte URL abfangen.
61
+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.
62 62
 
63
-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.
63
+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.
64 64
 Diese werden in ein Array $a->argv geparst und stimmen mit $a->argc überein, wobei sie die Anzahl der URL-Komponenten abbilden.
65
-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:
65
+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:
66 66
 
67 67
     $a->argc = 3
68
-    $a->argv = array(0 => 'plugin', 1 => 'arg1', 2 => 'arg2');
68
+    $a->argv = array(0 => 'addon', 1 => 'arg1', 2 => 'arg2');
69 69
 
70
-Deine Modulfunktionen umfassen oft die Funktion plugin_name_content(App $a), welche den Seiteninhalt definiert und zurückgibt.
71
-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.
72
-Du kannst ebenso plugin_name_init(App $a) nutzen, was oft frühzeitig aufgerufen wird und das Modul initialisert.
70
+Deine Modulfunktionen umfassen oft die Funktion addon_name_content(App $a), welche den Seiteninhalt definiert und zurückgibt.
71
+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.
72
+Du kannst ebenso addon_name_init(App $a) nutzen, was oft frühzeitig aufgerufen wird und das Modul initialisert.
73 73
 
74 74
 
75 75
 Derzeitige Hooks
@@ -109,10 +109,10 @@ Derzeitige Hooks
109 109
 **'settings_post'** - wird aufgerufen, wenn die Einstellungsseiten geladen werden.
110 110
     $b ist der $_POST-Array
111 111
 
112
-**'plugin_settings'** - wird aufgerufen, wenn die HTML-Ausgabe der Addon-Einstellungsseite generiert wird.
112
+**'addon_settings'** - wird aufgerufen, wenn die HTML-Ausgabe der Addon-Einstellungsseite generiert wird.
113 113
     $b ist die HTML-Ausgabe (String) der Addon-Einstellungsseite vor dem finalen "</form>"-Tag.
114 114
 
115
-**'plugin_settings_post'** - wird aufgerufen, wenn die Addon-Einstellungsseite geladen wird.
115
+**'addon_settings_post'** - wird aufgerufen, wenn die Addon-Einstellungsseite geladen wird.
116 116
     $b ist der $_POST-Array
117 117
 
118 118
 **'profile_post'** - wird aufgerufen, wenn die Profilseite angezeigt wird.
@@ -287,10 +287,6 @@ include/conversation.php:	Addon::callHooks('jot_tool', $jotplugins);
287 287
 
288 288
 include/conversation.php:	Addon::callHooks('jot_networks', $jotnets);
289 289
 
290
-include/plugin.php:		if(! function_exists('call_hooks')) {
291
-
292
-include/plugin.php:function 	Addon::callHooks($name, &$data = null) {
293
-
294 290
 index.php:			Addon::callHooks('init_1');
295 291
 
296 292
 index.php:			Addon::callHooks('app_menu', $arr);
@@ -327,13 +323,13 @@ mod/contacts.php:		Addon::callHooks('contact_edit_post', $_POST);
327 323
 
328 324
 mod/contacts.php:		Addon::callHooks('contact_edit', $arr);
329 325
 
330
-mod/settings.php:		Addon::callHooks('plugin_settings_post', $_POST);
326
+mod/settings.php:		Addon::callHooks('addon_settings_post', $_POST);
331 327
 
332 328
 mod/settings.php:		Addon::callHooks('connector_settings_post', $_POST);
333 329
 
334 330
 mod/settings.php:		Addon::callHooks('settings_post', $_POST);
335 331
 
336
-mod/settings.php:		Addon::callHooks('plugin_settings', $settings_addons);
332
+mod/settings.php:		Addon::callHooks('addon_settings', $settings_addons);
337 333
 
338 334
 mod/settings.php:		Addon::callHooks('connector_settings', $settings_connectors);
339 335
 

+ 4
- 4
doc/de/Settings.md View File

@@ -195,7 +195,7 @@ An dieser Stelle kannst du existierende Accounts vom Zugriff auf die Instanz blo
195 195
 Im letzten Bereich auf der Seite kannst du als Administrator neue Accounts anlegen.
196 196
 Das Passwort für so eingerichtete Accounts werden per E-Mail an die Nutzer geschickt.
197 197
 
198
-## Plugins
198
+## Addons
199 199
 
200 200
 Dieser Bereich des Admin Panels dient der Auswahl und Konfiguration der Erweiterungen von Friendica.
201 201
 Sie müssen in das `/addon` Verzeichnis kopiert werden.
@@ -203,11 +203,11 @@ Auf der Seite wird eine Liste der verfügbaren Erweiterungen angezeigt.
203 203
 Neben den Namen der Erweiterungen wird ein Indikator angezeigt, der anzeigt ob das Addon gerade aktiviert ist oder nicht.
204 204
 
205 205
 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.
206
-Um diesen Prozess zu vereinfachen gibt es am Anfang der Seite einen Button um alle aktiven Plugins neu zu laden.
206
+Um diesen Prozess zu vereinfachen gibt es am Anfang der Seite einen Button um alle aktiven Addons neu zu laden.
207 207
 
208 208
 ## Themen
209 209
 
210
-Der Bereich zur Kontrolle der auf der Friendica-Instanz verfügbaren Themen funktioniert analog zum Plugins Bereich.
210
+Der Bereich zur Kontrolle der auf der Friendica-Instanz verfügbaren Themen funktioniert analog zum Addons Bereich.
211 211
 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.
212 212
 Genau wie Erweiterungen können Themes in der Übersichtsliste oder der Theme-Seite aktiviert bzw. deaktiviert werden.
213 213
 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.
256 256
 Diese kann u.a. in der Adresse der `/display`-Seite gefunden werden, wenn man dem *Link zum Originalbeitrag* folgt.
257 257
 Hier ist die GUID der letzte Teil der URL in der Adresszeile des Browsers.
258 258
 
259
-## Plugin Features
259
+## Addon Features
260 260
 
261 261
 Einige der Erweiterungen von Friendica benötigen global gültige Einstellungen, die der Administrator vornehmen muss.
262 262
 Diese Erweiterungen sind hier aufgelistet, damit du die Einstellungen schneller findest.

Loading…
Cancel
Save