Tobias outlined a rare situation where a site admin may not have an
admin account, and will therefore need to do things in .htconfig.php So, restore the .htconfig.php method as "If you prefer..."pull/39/head
parent
3ea3cd9ec3
commit
1405c0c637
|
@ -20,6 +20,18 @@ Installing the Friendica/Facebook connector
|
||||||
c) Click save.
|
c) Click save.
|
||||||
d) Finally, return to the Facebook settings page, and activate real-time updates.
|
d) Finally, return to the Facebook settings page, and activate real-time updates.
|
||||||
|
|
||||||
|
i. If you for any reason prefer to use a configuration file instead of the admin panels,
|
||||||
|
Activate the plugin by including it in .htconfig.php, e.g.
|
||||||
|
|
||||||
|
$a->config['system']['addon'] = 'plugin1,plugin2,facebook';
|
||||||
|
|
||||||
|
and set the following values:
|
||||||
|
$a->config['facebook']['appid'] = 'xxxxxxxxxxx';
|
||||||
|
$a->config['facebook']['appsecret'] = 'xxxxxxxxxxxxxxx';
|
||||||
|
|
||||||
|
Replace with the settings Facebook gives you.
|
||||||
|
|
||||||
|
|
||||||
3. To use the Facebook plugin, visit the "connector settings" area of your settings
|
3. To use the Facebook plugin, visit the "connector settings" area of your settings
|
||||||
page. Click "Install Facebook Connector".
|
page. Click "Install Facebook Connector".
|
||||||
4. This will ask you to login to Facebook and allow the plugin to do it's stuff.
|
4. This will ask you to login to Facebook and allow the plugin to do it's stuff.
|
||||||
|
|
|
@ -0,0 +1,40 @@
|
||||||
|
Installing the Friendica/Facebook connector
|
||||||
|
|
||||||
|
1. Visit https://developers.facebook.com/apps to register an app.
|
||||||
|
a) Click "Create a new app"
|
||||||
|
b) We'd be very happy if you include "Friendica" in the application name
|
||||||
|
to increase name recognition.
|
||||||
|
c) Edit your app settings on the setup page. The Friendica icons are present
|
||||||
|
in the images directory and may be uploaded as a Facebook app icon. Use
|
||||||
|
images/friendica-16.jpg for the Icon and images/Friendica-128.jpg for the logo.
|
||||||
|
d) In the App Display name enter the name of your app (this should default to the
|
||||||
|
name you chose in part a).
|
||||||
|
e) Enter YourDomain.com in the App Domain field and hit return.
|
||||||
|
f) In "Select how your app connects with Facebook select "Website" and enter the
|
||||||
|
full URL to your Friendica install including HTTPS and a trailing slash.
|
||||||
|
|
||||||
|
2. Enable the Facebook plugin by clicking on the icon next to it's name on the plugin
|
||||||
|
page of your admin panel.
|
||||||
|
b) return to the Facebook plugin page in your admin panel, and fill in the App-ID
|
||||||
|
and Application Secret settings you got from Facebook.
|
||||||
|
c) Click save.
|
||||||
|
d) Finally, return to the Facebook settings page, and activate real-time updates.
|
||||||
|
|
||||||
|
3. To use the Facebook plugin, visit the "connector settings" area of your settings
|
||||||
|
page. Click "Install Facebook Connector".
|
||||||
|
4. This will ask you to login to Facebook and allow the plugin to do it's stuff.
|
||||||
|
Allow it to do so.
|
||||||
|
5. You're done. To turn it off visit the Plugin Settings page again and
|
||||||
|
'Remove Facebook posting'.
|
||||||
|
|
||||||
|
Vidoes and embeds will not be posted if there is no other content. Links
|
||||||
|
and images will be converted to a format suitable for the Facebook API and
|
||||||
|
long posts truncated - with a link to view the full post.
|
||||||
|
|
||||||
|
Facebook contacts will not be able to view private photos, as they are not able to
|
||||||
|
authenticate to your site to establish identity. We will address this
|
||||||
|
in a future release.
|
||||||
|
|
||||||
|
Info: please make sure that you understand all aspects due to Friendica's
|
||||||
|
default licence which is: MIT License (further info:
|
||||||
|
https://github.com/friendica/friendica/blob/master/LICENSE)
|
|
@ -15,4 +15,17 @@ Configuration:
|
||||||
Simply fill in the fields in the impressium settings page in the plugins area
|
Simply fill in the fields in the impressium settings page in the plugins area
|
||||||
of your admin panel.
|
of your admin panel.
|
||||||
|
|
||||||
|
If you for any reason prefer to use a configuration file instead, you can set the
|
||||||
|
following variables in the .htconfig file
|
||||||
|
|
||||||
|
* $a->config['impressum']['owner'] this is the Name of the Operator
|
||||||
|
* $a->config['impressum']['ownerprofile'] this is an optional Friendica account
|
||||||
|
where the above owner name will link to
|
||||||
|
* $a->config['impressum']['email'] a contact email address (optional)
|
||||||
|
will be displayed slightly obfuscated
|
||||||
|
as name(at)example(dot)com
|
||||||
|
|
||||||
|
* $a->config['impressum']['postal'] should contain a postal address where
|
||||||
|
you can be reached at (optional)
|
||||||
|
* $a->config['impressum']['notes'] additional informations that should
|
||||||
|
be displayed in the Impressum block
|
||||||
|
|
|
@ -0,0 +1,18 @@
|
||||||
|
Impressum Plugin for Friendica
|
||||||
|
|
||||||
|
Author: Tobias Diekershoff
|
||||||
|
tobias.diekershoff@gmx.net
|
||||||
|
|
||||||
|
License: 3-clause BSD license (same as Friendica)
|
||||||
|
|
||||||
|
About
|
||||||
|
This plugin adds an Impressum 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 HTML tags for formatting.
|
||||||
|
|
||||||
|
Configuration:
|
||||||
|
Simply fill in the fields in the impressium settings page in the plugins area
|
||||||
|
of your admin panel.
|
||||||
|
|
||||||
|
|
|
@ -16,6 +16,9 @@ Support the OpenStreetMap community and share the load.
|
||||||
|
|
||||||
___ Configuration ___
|
___ Configuration ___
|
||||||
|
|
||||||
|
If you for any reason prefer to use a configuration file instead
|
||||||
|
of the admin panels, please refer to the Alternative Configuration below.
|
||||||
|
|
||||||
Activate the plugin from your admin panel.
|
Activate the plugin from your admin panel.
|
||||||
|
|
||||||
You can now add a Tile Server and default zoom level in the plugin settings
|
You can now add a Tile Server and default zoom level in the plugin settings
|
||||||
|
@ -25,3 +28,21 @@ The Time Server URL points to the tile server you want to use. Use the full URL,
|
||||||
with protocol (http/s) and trailing slash. You can configure the default zoom
|
with protocol (http/s) and trailing slash. You can configure the default zoom
|
||||||
level on the map in the Default Zoom box. 1 will show the whole world and 18 is the highest
|
level on the map in the Default Zoom box. 1 will show the whole world and 18 is the highest
|
||||||
zoom level available.
|
zoom level available.
|
||||||
|
|
||||||
|
|
||||||
|
___ Alternative Configuration ___
|
||||||
|
|
||||||
|
Open the .htconfig.php file and add "openstreetmap" to the list of activated
|
||||||
|
addons.
|
||||||
|
|
||||||
|
$a->config['system']['addon'] = "openstreetmap, ..."
|
||||||
|
|
||||||
|
You have to add two configuration variables for the addon:
|
||||||
|
|
||||||
|
$a->config['openstreetmap']['tmsserver'] = 'http://www.openstreetmap.org/';
|
||||||
|
$a->config['openstreetmap']['zoom'] = '18';
|
||||||
|
|
||||||
|
The *tmsserver* points to the tile server you want to use. Use the full URL,
|
||||||
|
with protocol (http/s) and trailing slash. You can configure the default zoom
|
||||||
|
level on the map with *zoom*. 1 will show the whole world and 18 is the highest
|
||||||
|
zoom level available.
|
|
@ -0,0 +1,27 @@
|
||||||
|
____ OpenStreetMap Plugin ____
|
||||||
|
by Mike Macgirvin
|
||||||
|
Klaus Weidenbach
|
||||||
|
|
||||||
|
This addon allows you to use OpenStreetMap for displaying locations.
|
||||||
|
|
||||||
|
___ Requirements ___
|
||||||
|
|
||||||
|
To use this plugin you need a tile Server that provides the maps.
|
||||||
|
OpenStreetMap data is free for everyone to use. Their tile servers are not.
|
||||||
|
Please take a look at their "Tile Usage Policy":
|
||||||
|
http://wiki.openstreetmap.org/wiki/Tile_usage_policy
|
||||||
|
You can run your own tile server or choose one from their list of public
|
||||||
|
tile servers: http://wiki.openstreetmap.org/wiki/TMS
|
||||||
|
Support the OpenStreetMap community and share the load.
|
||||||
|
|
||||||
|
___ Configuration ___
|
||||||
|
|
||||||
|
Activate the plugin from your admin panel.
|
||||||
|
|
||||||
|
You can now add a Tile Server and default zoom level in the plugin settings
|
||||||
|
page of your admin panel.
|
||||||
|
|
||||||
|
The Time Server URL points to the tile server you want to use. Use the full URL,
|
||||||
|
with protocol (http/s) and trailing slash. You can configure the default zoom
|
||||||
|
level on the map in the Default Zoom box. 1 will show the whole world and 18 is the highest
|
||||||
|
zoom level available.
|
|
@ -48,7 +48,8 @@ ___ Configuration ___
|
||||||
__ Global Configuration __
|
__ Global Configuration __
|
||||||
|
|
||||||
If you enabled an administrator account, please use the admin panel to cofigure
|
If you enabled an administrator account, please use the admin panel to cofigure
|
||||||
the Twitter relay.
|
the Twitter relay. If you for any reason prefer to use a configuration file instead
|
||||||
|
of the admin panels, please refer to the Alternative Configuration below.
|
||||||
|
|
||||||
Activate the plugin from the plugins section of your admin panel. When you have
|
Activate the plugin from the plugins section of your admin panel. When you have
|
||||||
done so, add your consumer key and consumer secret in the settings section of the
|
done so, add your consumer key and consumer secret in the settings section of the
|
||||||
|
@ -58,6 +59,20 @@ When this is done your user can now configure their Twitter connection at
|
||||||
"Settings -> Plugin Settings" and enable the forwarding of their *public*
|
"Settings -> Plugin Settings" and enable the forwarding of their *public*
|
||||||
messages to Twitter.
|
messages to Twitter.
|
||||||
|
|
||||||
|
__ Alternative Configuration __
|
||||||
|
|
||||||
|
-To activate this addon add @twitter@ to the list of active addons in your
|
||||||
|
.htconfig.php file
|
||||||
|
|
||||||
|
$a->config['system']['addon'] = "twitter, ..."
|
||||||
|
|
||||||
|
Afterwards you need to add your OAuth consumer key / secret pair to it by
|
||||||
|
adding the following two lines
|
||||||
|
|
||||||
|
$a->config['twitter']['consumerkey'] = 'your consumer KEY here';
|
||||||
|
$a->config['twitter']['consumersecret'] = 'your consumer SECRET here';
|
||||||
|
|
||||||
|
|
||||||
__ User Configuration __
|
__ User Configuration __
|
||||||
|
|
||||||
When the OAuth consumer informations are correctly placed into the
|
When the OAuth consumer informations are correctly placed into the
|
||||||
|
@ -73,3 +88,4 @@ on the "Plugin Settings" page displaying two check boxes. One to enable/disable
|
||||||
the forwarding of *all public* postings to Twitter and one to clear the
|
the forwarding of *all public* postings to Twitter and one to clear the
|
||||||
personal configuration from the Twitter credentials.
|
personal configuration from the Twitter credentials.
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -0,0 +1,91 @@
|
||||||
|
____ Twitter Plugin ____
|
||||||
|
By Tobias Diekershoff
|
||||||
|
tobias.diekershoff(at)gmx.net
|
||||||
|
|
||||||
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||||
|
!! This addon is currently under development. If you have any problem !!
|
||||||
|
!! with it, please contact the Author. !!
|
||||||
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
||||||
|
|
||||||
|
With this addon to Friendica you can give your user the possibility to post
|
||||||
|
their *public* messages to Twitter. The messages will be strapped their rich
|
||||||
|
context and shortened to 140 characters length if necessary. If shortening of
|
||||||
|
the message was performed a link will be added to the Tweet pointing to the
|
||||||
|
original message on your server.
|
||||||
|
|
||||||
|
There is a similar addon for forwarding public messages to
|
||||||
|
"StatusNet":http://status.net [[StatusNet Plugin]].
|
||||||
|
|
||||||
|
Online version of this document: http://ur1.ca/35mml
|
||||||
|
|
||||||
|
___ Requirements ___
|
||||||
|
|
||||||
|
To use this plugin you have to register your Friendica instance as an
|
||||||
|
_client application_ for Twitter with _read and write_ access, we do not intend
|
||||||
|
to use Twitter for login. The registration can be done at twitter.com/apps
|
||||||
|
and you need to have a Twitter account to do so.
|
||||||
|
|
||||||
|
After you registered the application you get an OAuth consumer key / secret
|
||||||
|
pair that identifies your app, you will need them for configuration.
|
||||||
|
|
||||||
|
The inclusion of a shorturl for the original posting in cases when the
|
||||||
|
message was longer than 140 characters requires it, that you have *PHP5+* and
|
||||||
|
*curl* on your server.
|
||||||
|
|
||||||
|
___ Where to find ___
|
||||||
|
|
||||||
|
In the Friendica git repository /addon/twitter/, this directory contains
|
||||||
|
all required PHP files (including the Twitter OAuth library [1] by Abraham
|
||||||
|
Williams, MIT licensed and the Slinky library [2] by Beau Lebens, BSD license),
|
||||||
|
a CSS file for styling of the user configuration and an image to _Sign in with
|
||||||
|
Twitter_.
|
||||||
|
|
||||||
|
[1] https://github.com/abraham/twitteroauth
|
||||||
|
[2] http://dentedreality.com.au/projects/slinky/
|
||||||
|
|
||||||
|
___ Configuration ___
|
||||||
|
|
||||||
|
__ Global Configuration __
|
||||||
|
|
||||||
|
If you enabled an administrator account, please use the admin panel to cofigure
|
||||||
|
the Twitter relay. If you for any reason prefer to use a configuration file instead
|
||||||
|
of the admin panels, please refer to the Alternative Configuration below.
|
||||||
|
|
||||||
|
Activate the plugin from the plugins section of your admin panel. When you have
|
||||||
|
done so, add your consumer key and consumer secret in the settings section of the
|
||||||
|
plugin page.
|
||||||
|
|
||||||
|
When this is done your user can now configure their Twitter connection at
|
||||||
|
"Settings -> Plugin Settings" and enable the forwarding of their *public*
|
||||||
|
messages to Twitter.
|
||||||
|
|
||||||
|
__ Alternative Configuration __
|
||||||
|
|
||||||
|
-To activate this addon add @twitter@ to the list of active addons in your
|
||||||
|
.htconfig.php file
|
||||||
|
|
||||||
|
$a->config['system']['addon'] = "twitter, ..."
|
||||||
|
|
||||||
|
Afterwards you need to add your OAuth consumer key / secret pair to it by
|
||||||
|
adding the following two lines
|
||||||
|
|
||||||
|
$a->config['twitter']['consumerkey'] = 'your consumer KEY here';
|
||||||
|
$a->config['twitter']['consumersecret'] = 'your consumer SECRET here';
|
||||||
|
|
||||||
|
|
||||||
|
__ User Configuration __
|
||||||
|
|
||||||
|
When the OAuth consumer informations are correctly placed into the
|
||||||
|
configuration file and a user visits the "Plugin Settings" page they can now
|
||||||
|
connect to Twitter. To do so one has to follow the _Sign in with Twitter_
|
||||||
|
button (the page will be opened in a new browser window/tab) and get a PIN from
|
||||||
|
Twitter. This PIN has to be entered on the settings page. After submitting the
|
||||||
|
PIN the plugin will get OAuth credentials identifying this user from the
|
||||||
|
Friendica account.
|
||||||
|
|
||||||
|
If this first step was successful the Twitter configuration will be changed
|
||||||
|
on the "Plugin Settings" page displaying two check boxes. One to enable/disable
|
||||||
|
the forwarding of *all public* postings to Twitter and one to clear the
|
||||||
|
personal configuration from the Twitter credentials.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue