--- /dev/null
+Geonames Addon
+==============
+
+Authors Mike Macgirvin.
+
+Use Geonames service to resolve nearest populated location for given latitude, longitude.
+
+## Installation
+
+Pre-requisite: Register a username at geonames.org and set in config/local.ini.php
+
+ [geonames]
+ username = your_username
+
+Also visit http://geonames.org/manageaccount and enable access to the free web services.
\ No newline at end of file
==============================
* Author: Tobias Diekershoff
-* License: [3-clause BSD](http://opensource.org/licenses/BSD-3-Clause) license
- (see the LICENSE file in the addon directory)
+* License: [3-clause BSD](http://opensource.org/licenses/BSD-3-Clause) license (see the LICENSE file in the addon directory)
About
-----
-This addon adds an Impressum (contact) block to the /friendica page with
-informations about the page operator/owner and how to contact you in case of
-any questions.
+This addon adds an Impressum (contact) block to the /friendica page with informations about the page operator/owner and how to contact you in case of any questions.
-In the notes and postal fields you can use bbcode tags for formatting, like in
-normal friendica postings..
+In the notes and postal fields you can use bbcode tags for formatting, like in normal friendica postings..
Configuration
-------------
-Simply fill in the fields in the impressium settings page in the addons
-area of your admin panel. For email adresses the "@" symbol will be obfuscated
-in the source of the page to make in harder for harvesting tools.
+Simply fill in the fields in the impressium settings page in the addons area of your admin panel. For email adresses the "@" symbol will be obfuscated in the source of the page to make in harder for harvesting tools.
Manual Configuration
--------------------
by Tobias Diekershoff and Klaus Weidenbach
-This addon allows you to embed the code necessary for the FLOSS webanalytics
-tool Piwik into the Friendica pages.
+This addon allows you to embed the code necessary for the FLOSS webanalytics tool Piwik into the Friendica pages.
Requirements
------------
Where to find
-------------
-In the Friendica addon git repository `/piwik/piwik.php` and a CSS file for
-styling the opt-out notice.
+In the Friendica addon git repository `/piwik/piwik.php` and a CSS file for styling the opt-out notice.
Configuration
-------------
-The easiest way to configure this addon is by activating the admin panels of
-your ~friendica server and then enter the needed details on the config page
-for the addon.
+The easiest way to configure this addon is by activating the admin panels of your ~friendica server and then enter the needed details on the config page for the addon.
-If you don't want to use the admin panel, you can configure the addon through
-the config/local.ini.php file.
+If you don't want to use the admin panel, you can configure the addon through the config/local.ini.php file.
Open the config/local.ini.php file and add "piwik" to the list of activated addons.
Configuration fields
---------------------
-* The *baseurl* points to your Piwik installation. Use the absolute path,
-remember trailing slashes but ignore the protocol (http/s) part of the URL.
-* Change the *sideid* parameter to whatever ID you want to use for tracking your
-Friendica installation.
-* The *optout* parameter (true|false) defines whether or
-not a short notice about the utilization of Piwik will be displayed on every
-page of your Friendica site (at the bottom of the page with some spacing to the
-other content). Part of the note is a link that allows the visitor to set an
-_opt-out_ cookie which will prevent visits from that user be tracked by piwik.
-* The *async* parameter (true|false) defines whether or not to use asynchronous
-tracking so pages load (or appear to load) faster.
+* The *baseurl* points to your Piwik installation. Use the absolute path, remember trailing slashes but ignore the protocol (http/s) part of the URL.
+* Change the *sideid* parameter to whatever ID you want to use for tracking your Friendica installation.
+* The *optout* parameter (true|false) defines whether or not a short notice about the utilization of Piwik will be displayed on every page of your Friendica site (at the bottom of the page with some spacing to the
+other content). Part of the note is a link that allows the visitor to set an _opt-out_ cookie which will prevent visits from that user be tracked by piwik.
+* The *async* parameter (true|false) defines whether or not to use asynchronous tracking so pages load (or appear to load) faster.
Currently the optional notice states the following:
-> This website is tracked using the Piwik analytics tool. If you do not want
-> that your visits are logged this way you can set a cookie to prevent Piwik
-> from tracking further visits of the site (opt-out).
+> This website is tracked using the Piwik analytics tool. If you do not want that your visits are logged this way you can set a cookie to prevent Piwik from tracking further visits of the site (opt-out).
License
=======
-The _Piwik addon_ is licensed under the [3-clause BSD license][3] see the
-LICENSE file in the addons directory.
+The _Piwik addon_ is licensed under the [3-clause BSD license][3] see the LICENSE file in the addons directory.
[3]: http://opensource.org/licenses/BSD-3-Clause
=============
-Public Server is a Friendica addon which implements automatic account & post expiration so that a site may be used as a public
-test bed with reduced data retention.
+Public Server is a Friendica addon which implements automatic account & post expiration so that a site may be used as a public test bed with reduced data retention.
This is a modified version of the testdrive addon, DO NOT ACTIVATE AT THE SAME TIME AS THE TESTDRIVE ADDON.
The expiration date is updated when the user logs in.
-An email warning will be sent out approximately five days before the expiration occurs. Five days later the account is removed completely.
-
+An email warning will be sent out approximately five days before the expiration occurs.
+Five days later the account is removed completely.
=========
-Testdrive is a Friendica addon which implements automatic account expiration so that a site may be used as a public
-test bed.
+Testdrive is a Friendica addon which implements automatic account expiration so that a site may be used as a public test bed.
When an account is created on the site, it is given a hard expiration date of
[testdrive]
expiredays = 30
-Set this in your config/local.ini.php file to allow a 30 day test drive period. By default no expiration period is defined
-in case the addon is activated accidentally.
+Set this in your config/local.ini.php file to allow a 30 day test drive period.
+By default no expiration period is defined in case the addon is activated accidentally.
+There is no opportunity to extend an expired account using this addon.
+Expiration is final.
+Other addons may be created which charge for service and extend the expiration as long as a balance is maintained.
+This addon is purely for creating a limited use test site.
-There is no opportunity to extend an expired account using this addon. Expiration is final. Other addons may be created
-which charge for service and extend the expiration as long as a balance is maintained. This addon is purely for creating
-a limited use test site.
-
-An email warning will be sent out approximately five days before the expiration occurs. Once it occurs logins and many
-system functions are disabled. Five days later the account is removed completely.
+An email warning will be sent out approximately five days before the expiration occurs.
+Once it occurs logins and many system functions are disabled.
+Five days later the account is removed completely.
Main authors Tobias Diekershoff, Michael Vogel and Hypolite Petovan.
-This bi-directional connector addon allows each user to crosspost their Friendica public posts to Twitter, import their
-Twitter timeline, interact with tweets from Friendica, and crosspost to Friendica their public tweets.
+This bi-directional connector addon allows each user to crosspost their Friendica public posts to Twitter, import their Twitter timeline, interact with tweets from Friendica, and crosspost to Friendica their public tweets.
## Installation
To use this addon you have to register an [application](https://apps.twitter.com/) for your Friendica instance on Twitter.
+Register your Friendica site as "Client" application with "Read & Write" access we do not need "Twitter as login".
Please leave the field "Callback URL" empty.
+When you've registered the app you get the OAuth Consumer key and secret pair for your application/site.
After the registration please enter the values for "Consumer Key" and "Consumer Secret" in the [administration](admin/addons/twitter).
+## Alternative configuration
+
+Add your key pair to your global config/local.ini.php.
+
+ [twitter]
+ consumerkey = your consumer_key here
+ consumersecret = your consumer_secret here
+
+To activate the addon itself add it to the [system] addon setting.
+After this, users can configure their Twitter account settings from "Settings -> Addon Settings".
+
## License
The _Twitter Connector_ is licensed under the [3-clause BSD license][2] see the LICENSE file in the addons directory.
projects / friendica-addons.git / commitdiff