{"id":1114,"date":"2021-07-29T12:17:41","date_gmt":"2021-07-29T11:17:41","guid":{"rendered":"https:\/\/wearesmile.com\/help\/?post_type=ht_kb&#038;p=1114"},"modified":"2021-08-02T14:45:59","modified_gmt":"2021-08-02T13:45:59","slug":"configuring-smiles-bird-box-plugin-to-display-your-twitter-feed","status":"publish","type":"ht_kb","link":"https:\/\/wearesmile.com\/help\/documentation\/configuring-smiles-bird-box-plugin-to-display-your-twitter-feed\/","title":{"rendered":"Configuring SMILE&#8217;s Bird Box plugin to display your Twitter feed"},"content":{"rendered":"\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon\">If SMILE have designed a bespoke Twitter feed for display on your site, it is likely that it was achieved by our own &#8216;Bird Box&#8217; plugin. If you are unsure please contact us via Live Chat.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Using the plugin<\/h2>\n\n\n\n<p><a href=\"https:\/\/gitlab.com\/wearesmile\/creative\/plugins\/smile\/smile-bird-box\/-\/wikis\/Using-the-plugin\/edit\"><\/a><\/p>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"648\" height=\"606\" src=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/07\/Screenshot-2021-07-29-at-12.00.22.png\" alt=\"\" class=\"wp-image-1116\" srcset=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/07\/Screenshot-2021-07-29-at-12.00.22.png 648w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/07\/Screenshot-2021-07-29-at-12.00.22-300x281.png 300w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/07\/Screenshot-2021-07-29-at-12.00.22-50x47.png 50w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/07\/Screenshot-2021-07-29-at-12.00.22-60x56.png 60w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/07\/Screenshot-2021-07-29-at-12.00.22-100x94.png 100w\" sizes=\"auto, (max-width: 648px) 100vw, 648px\" \/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p>Once a member of the SMILE team has activated the plugin, head to the Bird Box settings page. You&#8217;ll find this in the WordPress settings menu labeled &#8216;Bird Box&#8217;.<\/p>\n\n\n\n<p>When you arrive you&#8217;ll find a couple of inputs &amp; a several buttons. We&#8217;ll start with the inputs. Input one is labelled Bearer token, input two is labeled User ID. As user Id is the easiest to retrieve, we&#8217;ll start there.<\/p>\n<\/div>\n<\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Get my user id<\/h3>\n\n\n\n<p>Visit&nbsp;<a href=\"https:\/\/tweeterid.com\/\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/tweeterid.com<\/a> and enter your twitter handle. This is the name used to @ message you on twitter. In the screenshot below we&#8217;ve used the SMILE twitter account. Hit &#8216;Convert&#8217; to retrieve your user ID.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"723\" src=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image1-1024x723.png\" alt=\"\" class=\"wp-image-1120\" srcset=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image1-1024x723.png 1024w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image1-300x212.png 300w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image1-768x542.png 768w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image1-50x35.png 50w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image1-60x42.png 60w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image1-100x71.png 100w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image1.png 1510w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Once you&#8217;ve been given the ID, in this example `14749543`, you should paste it into the user id input in the Bird Box settings page &amp; click the &#8216;save settings&#8217; button.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"379\" src=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image2-1024x379.png\" alt=\"\" class=\"wp-image-1121\" srcset=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image2-1024x379.png 1024w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image2-300x111.png 300w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image2-768x285.png 768w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image2-50x19.png 50w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image2-1536x569.png 1536w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image2-60x22.png 60w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image2-100x37.png 100w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image2.png 1684w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Generate a bearer token<\/h3>\n\n\n\n<p>The next phase requires you to have access to a twitter developer account. If you do not you can create a twitter account here:&nbsp;<a href=\"https:\/\/twitter.com\/home\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/twitter.com<\/a>. You can then apply for a developer account here:&nbsp;<a href=\"https:\/\/developer.twitter.com\/en\/apply-for-access\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/developer.twitter.com\/en\/apply-for-access<\/a>. Filling in the application with information that pertains to your use case.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"673\" src=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image3-1024x673.png\" alt=\"\" class=\"wp-image-1123\" srcset=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image3-1024x673.png 1024w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image3-300x197.png 300w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image3-768x505.png 768w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image3-50x33.png 50w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image3-1536x1010.png 1536w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image3-60x39.png 60w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image3-100x66.png 100w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image3.png 2004w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Once the application is complete you&#8217;ll need to wait for a confirmation email from twitter, before proceeding further.<\/p>\n\n\n\n<p>Once you&#8217;ve received the approval email. Which should look something like this:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"629\" src=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image4-1024x629.png\" alt=\"\" class=\"wp-image-1124\" srcset=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image4-1024x629.png 1024w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image4-300x184.png 300w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image4-768x472.png 768w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image4-50x31.png 50w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image4-60x37.png 60w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image4-100x61.png 100w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image4.png 1416w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Click the&nbsp;<a href=\"https:\/\/developer.twitter.com\/en\/portal\/register\/welcome\" rel=\"noreferrer noopener\" target=\"_blank\">developer account link<\/a>&nbsp;and you will be sent to a setup screen.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"537\" src=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image5-1024x537.png\" alt=\"\" class=\"wp-image-1125\" srcset=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image5-1024x537.png 1024w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image5-300x157.png 300w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image5-768x403.png 768w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image5-50x26.png 50w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image5-1536x805.png 1536w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image5-2048x1074.png 2048w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image5-60x31.png 60w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image5-100x52.png 100w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Name your app and hit the &#8216;Get Keys&#8217; button. Keep these safe and do not share them. These keys directly hold you responsible for information pulled from the api. The fields will contain long strings of characters. I have redacted mine in the screenshot below so as to keep them private.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"573\" src=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image6-1024x573.png\" alt=\"\" class=\"wp-image-1126\" srcset=\"https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image6-1024x573.png 1024w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image6-300x168.png 300w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image6-768x430.png 768w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image6-50x28.png 50w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image6-1536x859.png 1536w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image6-2048x1146.png 2048w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image6-60x34.png 60w, https:\/\/wearesmile.com\/help\/wp-content\/uploads\/sites\/3\/2021\/08\/image6-100x56.png 100w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>One of the keys listed should be a bearer token, copy it to your clipboard &amp; paste it into the bearer token input in the Bird Box settings page. Click the &#8216;save settings&#8217; button.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Generating my twitter timeline<\/h3>\n\n\n\n<p>Click the &#8216;update twitter feed button&#8217;. This will take the credentials saved in the above inputs and run a request off to the twitter api to fetch timeline data. It will also create a cron event that will regenerate the timeline every 24 hours, to pull in fresh tweets.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Don&#8217;t have a bespoke Twitter feed? <a href=\"https:\/\/wearesmile.com\/help\/change-control-request\/\">Get in touch<\/a> to find out how we can help you achieve an on-brand Twitter integration using Bird Box. <\/p>\n","protected":false},"excerpt":{"rendered":"<p>Using the plugin Once a member of the SMILE team has activated the plugin, head to the Bird Box settings page. You&#8217;ll find this in the WordPress settings menu labeled &#8216;Bird Box&#8217;. When you arrive you&#8217;ll find a couple of inputs &amp; a several buttons. We&#8217;ll start with the inputs&#8230;.<\/p>\n","protected":false},"author":5,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_searchwp_excluded":"","footnotes":""},"ht-kb-category":[92],"ht-kb-tag":[],"class_list":["post-1114","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-general"],"_links":{"self":[{"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/ht-kb\/1114","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/comments?post=1114"}],"version-history":[{"count":4,"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/ht-kb\/1114\/revisions"}],"predecessor-version":[{"id":1127,"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/ht-kb\/1114\/revisions\/1127"}],"wp:attachment":[{"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/media?parent=1114"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/ht-kb-category?post=1114"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/wearesmile.com\/help\/wp-json\/wp\/v2\/ht-kb-tag?post=1114"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}