{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/30277216","id":30277216,"diff_hunk":"@@ -0,0 +1,104 @@\n+.. include:: ../links.rst\n+\n+.. _Enable Social Sharing Icons:\n+\n+############################\n+Enable Social Sharing Icons\n+############################\n+\n+In the Open edX Cypress release, a new feature allows course staff to add\n+social sharing icons to their course listings in the LMS. Learners can select\n+these icons to create posts or tweets about their involvement in a course on\n+social sharing sites such as Facebook and Twitter without having to link their\n+accounts to these sites.\n+\n+To use this feature on your instance of Open edX, you must configure dashboard\n+sharing settings. Optionally, you can configure custom course URLs and specify\n+a Social Sharing URL for your course page in Studio. If a custom course URL is\n+provided, the post or tweet by the social sharing site can provide a link back\n+to the URL location. If you do not configure custom course URLS, the URL to\n+the course About page in the LMS is used.\n+\n+For information about social sharing icons, see the *Building and Running an\n+Open edX Course* guide.\n+\n+.. note::  \n+   Before proceeding, review :ref:`Guidelines for Updating the edX Platform`.\n+\n+\n+.. _Configure Dashboard Sharing:\n+\n+*******************************************************\n+Configure Dashboard Sharing\n+*******************************************************\n+\n+To enable social sharing icons for a course, follow these steps to enable\n+dashboard share settings in both Studio and the LMS.\n+\n+\n+#. In the  ``/cms/envs/common.py`` and ``/lms/envs/common.py`` files, add the\n+   ``DASHBOARD_SHARE_SETTINGS`` and social sharing flags. \n+   \n+   .. code-block:: bash\n+\n+       # Dashboard share settings feature flag\n+        \"DASHBOARD_SHARE_SETTINGS\": {\n+            \"FACEBOOK_SHARING\": true,\n+            \"TWITTER_SHARING\": false,\n+            \"TWITTER_SHARING_TEXT\": \n+\n+2. For each social sharing icon that you want to enable, set the value of the\n+   setting to ``True``.\n+\n+#. If you have set ``TWITTER_SHARING`` to ``True``, you can also specify\n+   default text that learners will see in the Twitter sharing dialog and that\n+   can be included in their tweet. Learners can edit this text before they\n+   select the **Share with Twitter** button in the LMS.\n+\n+#. Save the ``/cms/envs/common.py`` and ``/lms/envs/common.py`` files.\n+\n+\n+*****************************************\n+Configure Custom Course URLs (Optional)\n+*****************************************\n+\n+In addition to enabling the social sharing icons, if you want to provide a\n+custom URL for social sharing sites to link back to, follow these steps. You\n+must enable the setting in both Studio and the LMS, and specify the custom URL\n+in Studio **Advanced Settings**.\n+\n+If you do not configure a custom course URL, the URL to the course About page\n+in the LMS is used.\n+\n+\t.. note:: If you add the ``CUSTOM_COURSE_URLS`` flag and set it to ``True``\n+\t   but do not provide a value in the **Social Media Sharing URL** advanced\n+\t   setting in Studio, social sharing icons are not visible in the LMS.\n+\n+\n+#. In the ``/cms/envs/common.py`` and ``/lms/envs/common.py`` files, add the\n+   ``CUSTOM_COURSE_URLS`` setting under ``DASHBOARD_SHARE_SETTINGS`` and set\n+   it to ``True``.\n+ \n+   .. code-block:: bash\n+\n+       # Dashboard share settings feature flag\n+        \"DASHBOARD_SHARE_SETTINGS\": {\n+            \"CUSTOM_COURSE_URLS\": true,\n+            \"FACEBOOK_SHARING\": true,\n+            \"TWITTER_SHARING\": true,\n+            \"TWITTER_SHARING_TEXT\": Check out this fantastic course on edX!\n+\n+#. Save the ``/cms/envs/common.py`` and ``/lms/envs/common.py`` files.\n+\n+#. In Studio **Advanced Settings**, specify the custom course URL in the\n+   **Social Media Sharing URL** setting.\n+\n+\tThis URL is provided to the social sharing site for linking back to a\n+\tcourse location, such as the course About page. This URL is used only if\n+\tyou have :ref:`configured the dashboard share flags<Configure Dashboard\n+\tSharing>`.\n+\n+\t.. note:: If you add the ``CUSTOM_COURSE_URLS`` flag and set it to ``True``\n+\t   but do not provide a value in the **Social Media Sharing URL** advanced\n+\t   setting in Studio, social sharing icons are not visible in the LMS.","path":"en_us/install_operations/source/configuration/enable_socialsharing_icons.rst","position":103,"original_position":103,"commit_id":"0ec7f4265828eae4e2285827b5d6056203f337ce","original_commit_id":"0ec7f4265828eae4e2285827b5d6056203f337ce","user":{"login":"marcotuts","id":2023680,"avatar_url":"https://avatars.githubusercontent.com/u/2023680?v=3","gravatar_id":"","url":"https://api.github.com/users/marcotuts","html_url":"https://github.com/marcotuts","followers_url":"https://api.github.com/users/marcotuts/followers","following_url":"https://api.github.com/users/marcotuts/following{/other_user}","gists_url":"https://api.github.com/users/marcotuts/gists{/gist_id}","starred_url":"https://api.github.com/users/marcotuts/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/marcotuts/subscriptions","organizations_url":"https://api.github.com/users/marcotuts/orgs","repos_url":"https://api.github.com/users/marcotuts/repos","events_url":"https://api.github.com/users/marcotuts/events{/privacy}","received_events_url":"https://api.github.com/users/marcotuts/received_events","type":"User","site_admin":false},"body":"social sharing icons are not visible in the LMS + \"for that course\" (or something similar?)  ","created_at":"2015-05-13T21:17:22Z","updated_at":"2015-05-13T21:17:22Z","html_url":"https://github.com/edx/edx-documentation/pull/341#discussion_r30277216","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/341","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/30277216"},"html":{"href":"https://github.com/edx/edx-documentation/pull/341#discussion_r30277216"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/341"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/341","id":35355673,"html_url":"https://github.com/edx/edx-documentation/pull/341","diff_url":"https://github.com/edx/edx-documentation/pull/341.diff","patch_url":"https://github.com/edx/edx-documentation/pull/341.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/341","number":341,"state":"open","locked":false,"title":"Initial draft","user":{"login":"catong","id":9041399,"avatar_url":"https://avatars.githubusercontent.com/u/9041399?v=3","gravatar_id":"","url":"https://api.github.com/users/catong","html_url":"https://github.com/catong","followers_url":"https://api.github.com/users/catong/followers","following_url":"https://api.github.com/users/catong/following{/other_user}","gists_url":"https://api.github.com/users/catong/gists{/gist_id}","starred_url":"https://api.github.com/users/catong/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/catong/subscriptions","organizations_url":"https://api.github.com/users/catong/orgs","repos_url":"https://api.github.com/users/catong/repos","events_url":"https://api.github.com/users/catong/events{/privacy}","received_events_url":"https://api.github.com/users/catong/received_events","type":"User","site_admin":false},"body":"This PR provides Open edX configuration documentation for social sharing widgets (SOL-462, 463, 464, DOC-1880).\r\n@mattdrayer @marcotuts @partha can you please review? I am not sure about the Studio Advanced Setting in particular (line 93) -- can the URL be set in a file rather than via the Studio UI?","created_at":"2015-05-13T18:23:18Z","updated_at":"2015-05-13T21:17:22Z","closed_at":null,"merged_at":null,"merge_commit_sha":"88658ce7be49798def9c96581d2e4216c0842321","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/341/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/341/comments","review_comment_url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/edx/edx-documentation/issues/341/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/0ec7f4265828eae4e2285827b5d6056203f337ce","head":{"label":"edx:carol/doc/SocialSharingWidgets_OpenedX","ref":"carol/doc/SocialSharingWidgets_OpenedX","sha":"0ec7f4265828eae4e2285827b5d6056203f337ce","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","created_at":"2014-09-09T15:29:04Z","updated_at":"2015-05-09T08:33:56Z","pushed_at":"2015-05-13T20:30:41Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":null,"size":81825,"stargazers_count":14,"watchers_count":14,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":45,"mirror_url":null,"open_issues_count":18,"forks":45,"open_issues":18,"watchers":14,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"b14c032d94076a9d8f25f32e8d9f556d7c85416e","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","created_at":"2014-09-09T15:29:04Z","updated_at":"2015-05-09T08:33:56Z","pushed_at":"2015-05-13T20:30:41Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":null,"size":81825,"stargazers_count":14,"watchers_count":14,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":45,"mirror_url":null,"open_issues_count":18,"forks":45,"open_issues":18,"watchers":14,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/341"},"html":{"href":"https://github.com/edx/edx-documentation/pull/341"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/341"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/341/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/341/comments"},"review_comment":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/341/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/0ec7f4265828eae4e2285827b5d6056203f337ce"}}}}