From 4626157572bf20884cfad2b1fc0e24cd60bad918 Mon Sep 17 00:00:00 2001 From: luca-marie Date: Tue, 13 Sep 2016 14:47:29 +0200 Subject: Added what was once deleted by mistake --- app/assets/images/rails.png | Bin 0 -> 6646 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 app/assets/images/rails.png diff --git a/app/assets/images/rails.png b/app/assets/images/rails.png new file mode 100644 index 0000000..d5edc04 Binary files /dev/null and b/app/assets/images/rails.png differ -- cgit v1.2.3 From 45abd9751e3e7d5428bad81a433b85feae328a04 Mon Sep 17 00:00:00 2001 From: luca-marie Date: Tue, 13 Sep 2016 15:16:20 +0200 Subject: Restructuring README and documentation in doc file --- README.md | 29 ++--------------------------- doc/TWITTER_FEED.md | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 38 insertions(+), 27 deletions(-) create mode 100644 doc/TWITTER_FEED.md diff --git a/README.md b/README.md index 4d9ca39..923b239 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,7 @@ The LEAP Web App provides the following functions: * Webfinger access to user’s public keys * Email aliases and forwarding * Localized and Customizable documentation +* Display of status updates from Twitter (access to tweets via Twitter API) Written in: Ruby, Rails. @@ -36,6 +37,7 @@ For more information, see these files in the ``doc`` directory: * DEPLOY -- for notes on deployment. * DEVELOP -- for developer notes. * CUSTOM -- how to customize. +* TWITTER_FEED -- how to use it. External docs: @@ -186,30 +188,3 @@ Known problems attacks. These are very hard to prevent, because our protocol is designed to allow query of a user database via proxy in order to provide network perspective. - -Twitter Timeline on Main View ---------------------------- - -This is a feature to include a twitter feed that displays most recent tweets -of a (determined) twitter account (accessed via Twitter API). -If you chose to use it, the feature gets included in `home/index` of -LEAP web app (as part of the main view). - -* Create Twitter Application on https://apps.twitter.com/ - * Visit https://apps.twitter.com/ and log in with the twitter account you want to use - * Make sure you have a mobile phone number registered with your account to be able to proceed - * Choose the option to `Create New App` - * Fill in Application Details and Developer Agreement and `Create your Twitter application` - * Choose the section "Keys and Access Tokens" to get your consumer key and consumer secret - * Optional: Go to section "Permissions" and change the "Access" from `Read and Write` (by default) to `Read only` - * Have your consumer key and secret by hand for one of the next steps - -* Activate the feature within your local LEAP Web Application - * If not already existing create a secrets-file in /config with the name secrets.yml (`/config/secrets.yml`) - * Secrets-file should contain the following, make sure its in YAML: {"development"=> {"twitter"=>{"enabled"=>false, "twitter_handle"=>"", "bearer_token"=>"", "twitter_picture"=>nil}}, "test"=>{"twitter"=>{"enabled"=>false, "twitter_handle"=>"", "bearer_token"=>"", "twitter_picture"=>nil}}} - * To have your bearer token created, run script in terminal being in the file of leap_web: `script/generate_bearer_token` - * To have the script run properly you have to add before running: `--key your_consumerkey --secret your_consumersecret` - * Add also `--projectroot your_projectroot --twitterhandle your_twitterhandle` as well to not have manually put the data in your secrets-file - * The full command looks like this: `script/generate_bearer_token --key your_consumerkey --secret your_consumersecret --projectroot your_projectroot --twitterhandle your_twitterhandle` - * If you didn't give all your information to the script, had a typo or want to change anything else, please do so by finding the secrets-file at `/config/secrets.yml` - * Make sure that the correct twitterhandle and bearer-token is included diff --git a/doc/TWITTER_FEED.md b/doc/TWITTER_FEED.md new file mode 100644 index 0000000..12dc1be --- /dev/null +++ b/doc/TWITTER_FEED.md @@ -0,0 +1,36 @@ +Display of status updates from twitter on main view (access to tweets via Twitter API) +--------------------------- + +This is a feature to include status updates that displays most recent tweets +of a (determined) twitter account (accessed via Twitter API). +If you chose to use it, the feature gets included in `home/index` of +LEAP web app (as part of the main view). + +## How to use it ## + +* Create Twitter Application on https://apps.twitter.com/ + * Visit https://apps.twitter.com/ and log in with the twitter account you want to use + * Make sure you have a mobile phone number registered with your account to be able to proceed + * Choose the option to `Create New App` + * Fill in Application Details and Developer Agreement and `Create your Twitter application` + * Choose the section "Keys and Access Tokens" to get your consumer key and consumer secret + * Optional: Go to section "Permissions" and change the "Access" from `Read and Write` (by default) to `Read only` + * Have your consumer key and secret by hand for one of the next steps + +* Activate the feature within your local LEAP Web Application + * If not already existing create a secrets-file in /config with the name secrets.yml (`/config/secrets.yml`) + * Secrets-file should contain the following, make sure its in YAML: {"development"=> {"twitter"=>{"enabled"=>false, "twitter_handle"=>"", "bearer_token"=>"", "twitter_picture"=>nil}}, "test"=>{"twitter"=>{"enabled"=>false, "twitter_handle"=>"", "bearer_token"=>"", "twitter_picture"=>nil}}} + * To have your bearer token created, run script in terminal being in the file of leap_web: `script/generate_bearer_token` + * To have the script run properly you have to add before running: `--key your_consumerkey --secret your_consumersecret` + * Add also `--projectroot your_projectroot --twitterhandle your_twitterhandle` as well to not have manually put the data in your secrets-file + * The full command looks like this: `script/generate_bearer_token --key your_consumerkey --secret your_consumersecret --projectroot your_projectroot --twitterhandle your_twitterhandle` + * If you didn't give all your information to the script, had a typo or want to change anything else, please do so by finding the secrets-file at `/config/secrets.yml` + * Make sure that the correct twitterhandle and bearer-token is included + +* Deactivate your bearer token + * To deactivate your generated bearer token you can run script/invalidate_bearer_token + * The full command looks like this: script/invalidate_bearer_token --key your_consumerkey --secret your_consumersecret --token your_bearer_token + +### Default avatar image ### + +This feature uses by default the the twitter bird as avatar picture (Twitter_Logo_Blue.png). By using the Twitter trademarks in these Brand Guidelines, you agree to follow these Twitter Trademark Guidelines (the “Guidelines”) as well as our Terms of Service and all other Twitter rules and policies. Find more details here: https://brand.twitter.com/. -- cgit v1.2.3 From b19280e9937276d908d90be5da7c65cdfbb64be1 Mon Sep 17 00:00:00 2001 From: luca-marie Date: Tue, 13 Sep 2016 15:21:12 +0200 Subject: Fixed typo --- doc/TWITTER_FEED.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/TWITTER_FEED.md b/doc/TWITTER_FEED.md index 12dc1be..bfe2a1d 100644 --- a/doc/TWITTER_FEED.md +++ b/doc/TWITTER_FEED.md @@ -1,4 +1,4 @@ -Display of status updates from twitter on main view (access to tweets via Twitter API) +# Display of status updates from twitter on main view # --------------------------- This is a feature to include status updates that displays most recent tweets @@ -33,4 +33,4 @@ LEAP web app (as part of the main view). ### Default avatar image ### -This feature uses by default the the twitter bird as avatar picture (Twitter_Logo_Blue.png). By using the Twitter trademarks in these Brand Guidelines, you agree to follow these Twitter Trademark Guidelines (the “Guidelines”) as well as our Terms of Service and all other Twitter rules and policies. Find more details here: https://brand.twitter.com/. +This feature uses by default the twitter bird as avatar picture (Twitter_Logo_Blue.png). By using the Twitter trademarks in these Brand Guidelines, you agree to follow these Twitter Trademark Guidelines (the “Guidelines”) as well as our Terms of Service and all other Twitter rules and policies. Please find more details here: https://brand.twitter.com/. -- cgit v1.2.3 From 8a9c46dd6bd2538bf9f126ec6901d4ce3ebd2758 Mon Sep 17 00:00:00 2001 From: luca-marie Date: Tue, 13 Sep 2016 15:23:11 +0200 Subject: Fixed typo --- doc/TWITTER_FEED.md | 1 - 1 file changed, 1 deletion(-) diff --git a/doc/TWITTER_FEED.md b/doc/TWITTER_FEED.md index bfe2a1d..218bc26 100644 --- a/doc/TWITTER_FEED.md +++ b/doc/TWITTER_FEED.md @@ -1,5 +1,4 @@ # Display of status updates from twitter on main view # ---------------------------- This is a feature to include status updates that displays most recent tweets of a (determined) twitter account (accessed via Twitter API). -- cgit v1.2.3