Mercurial > pumpbridge > pumpbridge

comparison README.md @ 9:8363d4970c75

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
changed README and added twitter to pumpbridge.json.example
author Mathias Gebbe <mgebbe@intevation.de>
date Wed, 11 Jun 2014 22:34:20 +0200
parents a94ac7c3b182
children ccf1d9e741bd
comparison
equal deleted inserted replaced
8:6fd0a307850f 9:8363d4970c75
1 # pumpbridge 1 # pumpbridge
2 2
3 connects pump.io to facebook and googleplus 3 connects pump.io to facebook and googleplus
4 4
5 ### Features 5 THIS SOFTWARE IS A PROOF OF CONCEPT DEMONSTRATION
6 6
7 ####g+ 7 ## Features
8
9 ###g+ (read only)
8 10
9 * get all public posts from your circles 11 * get all public posts from your circles
10 and convert it to pump notes 12 and convert it to pump notes
11 (text, links, pics, videos) 13 (text, links, pics, videos)
12 14
13 ####facebook 15 ###facebook (read / write)
14 16
15 * get facebook newsfeed 17 * get facebook newsfeed including some non-public posts
18 depending on your friends privacy configuration
16 (text, links, pics, videos) 19 (text, links, pics, videos)
17 20
18 * post public pump posts to facebook 21 * post public pump posts and public shares to facebook
19 22
20 * likes and comments to facebook related pump notes 23 * likes and comments to facebook related pump notes
21 are synced to facebook 24 are synced to facebook
22 25
23 #### twitter 26 ###twitter (read / write)
24 27
25 * get tweets from all you follow and post them to pump.io 28 * get all tweets and retweets of the people you're following on twitter
26 29
27 * post public pump posts to twitter (max 140 characters) 30 * post public pump posts and public shares to twitter
28 31
29 ####benefits 32 ###benefits
30 33
31 * share googleplus posts to facebook and pump.io 34 * share posts between networks.
35 For example, you can share a post from googleplus/facebook/twitter to your followers in pump.io.
32 36
33 ## License 37 ##start bridging
38
39 * login to a remote pump.io account to get started
40
41 * check your pump.io id (logged in as:)
42
43 * login to your established social network:
44
45 * Twitter:
46 * click on Twitter icon
47 * login
48 * your account will be synced immediately
49 and you got all posts within the last interval (default 15min)
50
51 * Facebook:
52 * click on Facebook icon
53 * login
54 * click save credentials
55 * your account will be synced to the next interval (default 15min)
56 * pumpbridge syncs your public pump.io posts you made within the last interval
57 * pumpbridge syncs facebooks posts within the last interval
58 (depending on timezone it differs a little bit)
59
60 * Googleplus:
61 * click on Google icon
62 * login
63 * click save credentials
64 * your account will be synced to the next interval (default 15min)
65 * pumpbridge syncs google posts within the last interval
66 (since g+-api is read only you can not post to googleplus)
67
68 * click save credentials
69
70 * logout
71
72 ##stop bridging
73
74 * login to a remote pump.io account
75
76 * click on delete credentials on the specify social network
77 (in certain circumstances you still see your loginname even
78 if all token were deleted)
79
80 #Video
81
82 https://www.youtube.com/watch?v=SB2CGFnrnLY (older version without )
83
84 #SSL
85
86 see https://github.com/e14n/pump.io/wiki/StartSSL-Free-Certificate
87
88 #Bugs
89
90 #To-Do and wishlist
91
92 * sync comments from googleplus to pump.io
93 * sync comments from facebook to pump.io
94 * sync comments from pump.io to facebook
95
96 # License
34 97
35 Copyright (C) 2014 98 Copyright (C) 2014
36 Intevation GmbH <intevation@intevation.de> 99 Intevation GmbH <intevation@intevation.de>
37 Neuer Graben 17, D-49074 Osnabrueck, 100 Neuer Graben 17, D-49074 Osnabrueck,
38 Germany 101 Germany
50 distributed under the License is distributed on an "AS IS" BASIS, 113 distributed under the License is distributed on an "AS IS" BASIS,
51 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 114 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
52 See the License for the specific language governing permissions and 115 See the License for the specific language governing permissions and
53 limitations under the License. 116 limitations under the License.
54 117
55 #####Authors 118 ##Authors
56 119
57 Mathias Gebbe <mgebbe@intevation.de> 120 Mathias Gebbe <mgebbe@intevation.de>
58 121
59 #####Media 122 ##Media
60 123
61 * bridge (bridge.png): http://commons.wikimedia.org/wiki/File:Bridge-stone.svg 124 * bridge (bridge.png): http://commons.wikimedia.org/wiki/File:Bridge-stone.svg
62 * facebook (fb.svg): http://commons.wikimedia.org/wiki/File:F_icon.svg 125 * facebook (fb.svg): http://commons.wikimedia.org/wiki/File:F_icon.svg
63 * googleplus (gp.svg): http://commons.wikimedia.org/wiki/File:Google_plus.svg 126 * googleplus (gp.svg): http://commons.wikimedia.org/wiki/File:Google_plus.svg
64 * pump.io (pumpiologo.svg): https://en.wikipedia.org/wiki/Pump.io#mediaviewer/File:Pump.io.svg 127 * pump.io (pumpiologo.svg): https://en.wikipedia.org/wiki/Pump.io#mediaviewer/File:Pump.io.svg
65 * background (grey_wash_wall.png): http://subtlepatterns.com/grey-washed-wall/ (CC BY-SA 3.0) 128 * background (grey_wash_wall.png): http://subtlepatterns.com/grey-washed-wall/ (CC BY-SA 3.0)
66 129
67 #####Sources 130 ##Sources
68 131
69 The source files can be check out as follows 132 The source files can be check out as follows
70 ``` 133 ```
71 hg clone https://hg.wald.intevation.org/pumpbridge/ 134 hg clone https://hg.wald.intevation.org/pumpbridge/
72 ``` 135 ```
73 parts from https://github.com/e14n/pump2status are used! 136 this software is based on https://github.com/e14n/pump2status and
137 uses many tools from https://github.com/e14n/
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)