Setting up a Twitter application is a lengthy process for new users #3533

Erioldoesdesign · 2019-05-09T13:05:45Z

When setting up Twitter as a data source our first step that we advise users do is to 'Create a new Twitter application'

Recently Twitter has added a lengthy process to be approved for a twitter application and we could offer new users some more advice as to how to get approved and what Twitter needs to approve.

Links to Twitters application documentation would be useful for users.
https://developer.twitter.com/en/apps/create

You also must have a twitter account in order to set up an application and even view the docs.

Is your feature request related to a problem? Please describe.
Users would be frustrated if they needed to set up twitter feeds into platform within a short period of time. Especially if they are not familiar with this kind of set up.

Describe the solution you'd like
A short description on what a twitter application requires e.g. An existing or new Twitter account preferably linked to your project or organisation, a short description of what kind of twitter information you will gather and what you will do with it,

A short text that reads ' Twitter applications may take a few hours or a few days to be approved by Twitter. Please be aware of this if you need this data quickly'

To reproduce/see this section

To Reproduce
Steps to reproduce the behavior:

Go to a deployment you have admin access to
Log in as 'an admin'
Click on 'settings'
Scroll down to 'data sources'
Choose 'Twitter'
You will see the "Create new twitter application" section/link.

Task: Adding new descriptions to solve this ticket

In the text that says 'Create a new twitter application" add "Twitter applications may take a few hours or a few days to be approved by Twitter. Please be aware of this if you need this data quickly." (note: please feel free to improve on this!) -> this section can be added to the en.json key "intro_step_1_desc" in app/common/locales/en.json within the platform-client repo.

Working on this issue

The repository for this change is https://github.com/ushahidi/platform-client. Start here https://docs.ushahidi.com/platform-developer-documentation/getting-started if you have not set up the Ushahidi client before. Notice that you only need to install the platform-client (no need to set up the API for this) as long as you connect it to a live ushahidi.io or Ushahidi testing deployment.

Implementation notes

Fix in https://github.com/ushahidi/platform-client repo
Hint 💡 The code handling users can be found here: https://github.com/ushahidi/platform-client/tree/develop/app/settings/users
When you are done, 🔀 Start a Pull Request. There are two ways how you can start a pull request:
1. If you are familiar with the terminal or would like to learn it, here is a great tutorial on how to send a pull request using the terminal.
2. You can also edit files directly in your browser and open a pull request from there.
🏁 When done Ask in comments for a review :)

Want to work on this issue?🙋

Comment below. If someone else has claimed it, ask if they've opened a pull request already and if they're stuck -- maybe you can help them solve a problem or move it along!

Ping @rowasc if you need help with this issue!

hhold · 2019-10-01T17:27:57Z

Came across a project called Twint, it doesn't need an API key and can do tweet scraping, just thought I'd share in case it's helpful.

rowasc · 2019-10-01T18:07:46Z

Hi @hyperhitesh twint is not something we can use at the time. The Twitter ToS prohibits scrapping without explicit consent from Twitter, so we cannot use it. Thanks anyway for the recommendation! :)

Jenniline · 2019-11-30T22:55:54Z

Hi @rowasc,
I will like to be assigned this issue.
I need help with this issue. It is quite straight forward and the hint is a lot of help. However, I don't seem to find the line of code from where this issue is from.
I have gone through the link on the hint and searched all the code files for the text that says "Create a new Twitter application" but I have not found it.
Please direct me on where I can find the text so as that I can work on this issue.

Thanks

Angamanga · 2019-12-03T08:01:48Z

@Jenniline Thanks for looking into this issue. You find the code for this issue in the datasources-folder: https://github.com/ushahidi/platform-client/tree/develop/app/settings/datasources. What makes it confusing is that the text is coming from the api at this point (https://github.com/ushahidi/platform/blob/develop/src/App/DataSource/Twitter/Twitter.php), so that is why you don't find it :) You could still add the description in the datasource.html-file!

Good luck and reach out if you need more guidance🎉 !

leninpaulino · 2020-02-04T05:57:06Z

@Jenniline are you currently working on this?

Jenniline · 2020-02-04T06:41:47Z

Hi @leninpaulino Yes i am currently working on this issue.
You can still find more issues on the issue tracker, and keep in mind that Ushahidi has a platform and a platform-client it is good that you set up environment for each because some issues will need you to run the problem and see the behavior before being able to solve.
You can reach me if you need help.

Jenniline · 2020-02-05T17:42:36Z

Hi @leninpaulino Yes I am. Almost done with it

leninpaulino · 2020-02-05T19:21:00Z

Nice, I'll try to do the setup and after that, I'll move with something else from the issues. Thanks.

Jenniline · 2020-02-05T19:34:44Z

Alright, you can ping me anytime if you need help.

Jenniline · 2020-02-05T19:39:08Z

Hi, @Angamanga and @rowasc I have made 2 pull request for this issue. Please review and correct me where necessary

I edited the en.json file as described by @Erioldoesdesign in the problem description.
And the Twitter.php file They now display informing new users of the lengthy process of creating a new Twitter application

Do I still need to edit the datasources.html file?
Please let me know

…lication" Solved issue ushahidi#3533 by editing the label "create a new Twitter application" I added the sentences ""Twitter applications may take a few hours or a few days to be approved by Twitter. Please be aware of this if you need this data quickly.',.

… application" Solved issue ushahidi#3533 by editing the label "create a new Twitter application" I added the sentences "Twitter applications may take a few hours or a few days to be approved by Twitter. Please be aware of this if you need this data quickly.',.

Erioldoesdesign · 2020-02-06T10:31:09Z

Hey @Jenniline I'm gonna comment in the pull request conversation as I have just a few wording tweaks from my perspective of having raised this issue :)

I hope that's okay @Angamanga and @rowasc

Solved issue #3533 by editing the label "create a new Twitter applica…

Angamanga · 2020-02-12T18:30:05Z

@Obadha2 Can you test QA this in Steve Buscemi please?
Testing checklist:

As logged as admin, go to settings -> datasources
Select Twitter
The text should warn the user that setting up Twitter may take time (It should say: " Create a new Twitter application: Twitter applications may take a few hours or days to be approved by Twitter. Please be aware of this if you need this data quickly.

AmTryingMyBest · 2020-02-18T12:42:36Z

@Angamanga @Erioldoesdesign @Jenniline could we have this appearing as two different sets of information such that the second part of the text appears as additional information, italicised perhaps. Rather than a long string of text, have something ilke:
Step 1: Create a New Twitter application.
Twitter applications may take a few hours or days to be approved by Twitter. Please be aware of this if you need this data quickly.

Erioldoesdesign · 2020-02-18T14:14:08Z

@Obadha2 Makes sense. I would say it should be located after the text link 'new twitter application' that already exists in the layout in italics:

Jenniline · 2020-02-19T16:37:21Z

Ok, I see.
@Erioldoesdesign and @Obadha2 will it look better this way?

Step 1: Create a new Twitter application
Create a new Twitter application
Twitter applications may take a few hours or days to be approved by Twitter.
Please be aware of this if you need this data quickly

Is this better?

AmTryingMyBest · 2020-02-20T07:03:33Z

@Obadha2 Makes sense. I would say it should be located after the text link 'new twitter application' that already exists in the layout in italics:

@Erioldoesdesign with that we'd have the text "Create a new Twitter application" appear twice. I suggest we avoid that?
Would this appear better?

Step 1: Create a new Twitter application.
Twitter applications may take a few hours or days to be approved by Twitter.
Please be aware of this if you need this data quickly

Angamanga · 2020-02-24T09:52:28Z

@Jenniline The change @Obadha2 suggests is good. Do you have time to go ahead and change that?

Jenniline · 2020-02-25T04:20:55Z

Yes I will @Angamanga
Thanks

Jenniline · 2020-03-02T08:09:12Z

Hi Anna,
I Have made the changes requested. Here is the link to the Pull request
#3858
I made the changes to the Twitter.php file because that was the file I thought needed the changes you mentioned above and since you had already merged the pull requests to the en.json file.
If not please let me know if I should make any more changes to any other files.

Thanks

Angamanga · 2020-03-02T13:32:50Z

@Obadha2 Could you recheck in Steve Buscemi? The text should now look like this (had to keep the link in the description because of styling-issues. The link did not look ok as a label/headline):

AmTryingMyBest · 2020-03-03T09:31:28Z

Alright, this looks good @Angamanga ! 👍
Thanks @Jenniline

Erioldoesdesign added Community Task Issues that the Ushahidi OSS community is encouraged to contribute to P4 - Wishlist good-first-issue Issues that are ideal for first time contributors to OSS or first time contributing to the platform labels May 9, 2019

rowasc added the Theme: Twitter label Jun 10, 2019

rowasc added Size: S and removed P4 - Wishlist labels Jun 18, 2019

rowasc mentioned this issue Jun 24, 2019

Access Denied When Configuring twitter #1799

Closed

rowasc added the Hacktoberfest Issues open to folks participating in hacktoberfest label Sep 28, 2019

Jenniline mentioned this issue Feb 5, 2020

Solved issue #3533 by editing the label "create a new Twitter applica… #3840

Merged

1 task

Angamanga assigned Jenniline Feb 7, 2020

Angamanga added a commit that referenced this issue Feb 12, 2020

Merge pull request #3840 from Jenniline/patch-2

aca0183

Solved issue #3533 by editing the label "create a new Twitter applica…

Jenniline mentioned this issue Feb 12, 2020

1 Solving issue #3533 ushahidi/platform-client#1422

Merged

1 task

Angamanga mentioned this issue Mar 2, 2020

Twitter text #3859

Merged

1 task

Angamanga closed this as completed Mar 4, 2020

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Setting up a Twitter application is a lengthy process for new users #3533

Setting up a Twitter application is a lengthy process for new users #3533

Erioldoesdesign commented May 9, 2019 •

edited by rowasc

Loading

hhold commented Oct 1, 2019

rowasc commented Oct 1, 2019

Jenniline commented Nov 30, 2019

Angamanga commented Dec 3, 2019

leninpaulino commented Feb 4, 2020

Jenniline commented Feb 4, 2020

Jenniline commented Feb 5, 2020

leninpaulino commented Feb 5, 2020

Jenniline commented Feb 5, 2020

Jenniline commented Feb 5, 2020 •

edited

Loading

Erioldoesdesign commented Feb 6, 2020

Angamanga commented Feb 12, 2020

AmTryingMyBest commented Feb 18, 2020

Erioldoesdesign commented Feb 18, 2020

Jenniline commented Feb 19, 2020 •

edited

Loading

AmTryingMyBest commented Feb 20, 2020

Angamanga commented Feb 24, 2020

Jenniline commented Feb 25, 2020 •

edited

Loading

Jenniline commented Mar 2, 2020

Angamanga commented Mar 2, 2020

AmTryingMyBest commented Mar 3, 2020

Setting up a Twitter application is a lengthy process for new users #3533

Setting up a Twitter application is a lengthy process for new users #3533

Comments

Erioldoesdesign commented May 9, 2019 • edited by rowasc Loading

To reproduce/see this section

Task: Adding new descriptions to solve this ticket

Working on this issue

Implementation notes

Want to work on this issue?🙋

hhold commented Oct 1, 2019

rowasc commented Oct 1, 2019

Jenniline commented Nov 30, 2019

Angamanga commented Dec 3, 2019

leninpaulino commented Feb 4, 2020

Jenniline commented Feb 4, 2020

Jenniline commented Feb 5, 2020

leninpaulino commented Feb 5, 2020

Jenniline commented Feb 5, 2020

Jenniline commented Feb 5, 2020 • edited Loading

Erioldoesdesign commented Feb 6, 2020

Angamanga commented Feb 12, 2020

AmTryingMyBest commented Feb 18, 2020

Erioldoesdesign commented Feb 18, 2020

Jenniline commented Feb 19, 2020 • edited Loading

AmTryingMyBest commented Feb 20, 2020

Angamanga commented Feb 24, 2020

Jenniline commented Feb 25, 2020 • edited Loading

Jenniline commented Mar 2, 2020

Angamanga commented Mar 2, 2020

AmTryingMyBest commented Mar 3, 2020

Erioldoesdesign commented May 9, 2019 •

edited by rowasc

Loading

Jenniline commented Feb 5, 2020 •

edited

Loading

Jenniline commented Feb 19, 2020 •

edited

Loading

Jenniline commented Feb 25, 2020 •

edited

Loading