Update to Twitter app configuration docs.

gwu-libraries · Jun 15, 2018 · 0dc3a69 · 0dc3a69
1 parent 8b60bf6
commit 0dc3a69
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 5 deletions.
diff --git a/docs/credentials.rst b/docs/credentials.rst
@@ -61,8 +61,12 @@ Twitter
 
   For detailed instructions, see :ref:`twitter-credentials`.
 
-  It is recommended to change the application permissions to read-only.  You
-  *must* provide a callback URL, but the URL you provide doesn't matter.
+  You *must* provide a callback URL which is *http://<SFM hostname>/accounts/twitter/login/callback/*.
+  Note that this should be *http* not *https* even if you are using https.
+
+  Also, turn on *Enable Callback Locking* and *Allow this application to be used to Sign in with Twitter*.
+
+  It is recommended to change the application permissions to read-only.
 
 Flickr
   Flickr credentials can be obtained from
@@ -117,8 +121,7 @@ To manually add credentials:
   * **Enter a description.** You may copy and paste:
     *This is a social media research and archival tool, which collects data for
     academic researchers through an accessible user interface.*
-    * **Enter a Website** such as the SFM url. Any website will work.
-  * **Enter a Callback URL** that is the SFM url.
+  * **Enter a Website** such as the SFM url. Any website will work.
   * **Review and agree to the Twitter Developer Agreement** and click *Create
     your Twitter Application.*
   * Recommended:

diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst
@@ -59,7 +59,7 @@ configured correctly. For more information, see `ALLOWED_HOSTS <https://docs.dja
 Social Network Login Failure for Twitter
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 If you receive a Social Network Login Failure when trying to connect a Twitter account, make sure that the Twitter app
-from which you got the Twitter credentials is configured with a callback URL. The URL you provide doesn't matter.
+from which you got the Twitter credentials is configured with a callback URL. The URL should be *http://<SFM hostname>/accounts/twitter/login/callback/*.
 
 If you have made a change to the credentials configured in ``.env``, try deleting twitter from Social Applications in the admin interface and restarting SFM UI (``docker-compose stop ui`` then ``docker-compose up -d``).