This article is for sites that use a version of WordPress that is either downloaded from WordPress.org and self-hosted or that is hosted by a third-party service provider (such as GoDaddy). This document is a step-by-step description of how to create the Outbrain Select syndication template page (page where posted articles will be viewed on your website) and recommendation widgets in just a few clicks. This guide accompanies the following general knowledgebase articles that you'll also want to check out: 

 


 

Since WordPress offers a wide variety of templates and settings, you may find that your site setup is slightly different than what is described in this guide. If you run into any questions just open a ticket and let us know. We'll be happy to walk you through it if you need help.

Additionally, where you see the Outbrain icon, , that means the corresponding step is done in Outbrain Select. Likewise, where you see the WordPress icon, wordpress.png, you will complete that step in WordPress. 


  

Creating your syndication template page

 

 1. Create your syndication template page and choose your styling options inside Select.


 

wordpress.png 2. In the WordPress admin area, navigate to the "Pages" section.

 Pages Section.jpg



wordpress.png 3. Click on "Add New". Make sure to give it a title (e.g. Articles). Then switch to HTML mode by clicking the "HTML" button in the editing toolbar and paste the Select JavaScript library tag and DIV element into the content area. That's it! You don't need any more content on the page. 

  


 
 

wordpress.png 4. Click the "Publish" button (or "Update" if you've already saved the page once). You'll now see the new page listed in your Pages section. 


 

Publish Section.jpg


 

wordpress.png 5. Click on the name of the page to view it on your site. You won't see any content quite yet...there are a just a couple steps left. Copy the URL of the page you just created from the address bar of your browser and switch back to Select. 

Additionally, at this point you may want to keep the page out of your navigation menu as it will only display a blank page by default. When someone clicks on the URL of an article you have shared it will still land on this page but this time the content will load rather than a blank page. You can find more information on hiding pages in the "Additional Notes" section of this document.
 

 

 6. In Select, navigate to Setup > Template and click the "Enter it here" link in the notification message indicating you need to enter the URL of your template page.


 

Scribit URL Warning.png 

 

 

 7. Paste the URL of your syndication page into the "Page URL" field and click the "Update" button.


 

 Scribit URL Paste.jpg

 

 

 8. After you add the URL you can click the example link in the confirmation message to see how content will look in your new syndication template page. You'll also be able to start posting and sharing content (just make sure to set up your social connections). You can also update the styling on the syndicated content by navigating back to Setup > Template in Select.

 

 

wordpress.png 9. Again, if you have your Pages set to show in Widgets Primary and Secondary navigation menus  (or whatever other option your template supports), you'll want to hide your new syndication template page from the navigation since it doesn't load any content by default without having the "vaid" URL parameter on the end of it. The best way to keep this page hidden is to set up a custom menu. For more information on setting up custom menus please see this WordPress.org support document.

 


Creating recommendation widgets 

 
 

 1. In the Setup menu, choose widgets and the "New Widget" to create a recommendation widget and choose your styling options inside Select. Again, for more detailed information on setting up your widget in Select see our document on setting up recommendation widgets

As a side note, it is probably best to use a list widget if you will place your widget in the Sidebar area of your site. A tile or list widget both work fine in the footer area, directly below posts or below the Select content DIV on your syndication template page. 

 

 

wordpress.png 2. In the WordPress admin area, Navigate to the "Appearance" section and click on the "Widgets" menu.

 
 

Widget Select.jpg 

 

 

wordpress.png 3. Select and drag a new "Text" widget from the Available Widgets list and place it into one of the sidebar or footer areas you would like.

 

 New Widget Screen.jpg

 

 

wordpress.png 4. We suggest that you leave the title on the widget blank. This will allow to leverage the widget header that is available in the widget configuration tools inside Select. Paste the Select JavaScript library tag and rec widget DIV code into the content area. Finally, click the "Save" button.

 

 


 

wordpress.png 5. Navigate back to any standard template page and you should see your new gadget. You can always go back to the Appearance > Widgets screen to place and move the widget into a different area of your layout if you want. 

 

 6. You will probably want to tweak your rec widget layout and styling inside the Setup > Widgets area of Select. You can make as many changes as you need to get your recommendation widget looking just right for your site. You can also add more widgets to different areas of your site by repeating these steps.
 

 

Additional Notes


WordPress Version


WordPress Themes:
  • Some WordPress themes may not allow you to add widgets or hide the syndication template page.

Widget Placement:
  • You can also place a recommendation widget at the bottom of your syndication template page. Just paste the widget div code below the main syndication content div code. This allows you to keep your visitor engaged by showing them additional articles when they finish reading the current one. 

Excluding Syndication Page from Navigation Menu:
  • One plugin for excluding a page from navigation is called "Exclude Pages". This plugin enables you to create the template page without displaying an empty page in your nav menu (something some themes don't allow by default.) The plugin site is: http://wordpress.org/extend/plugins/exclude-pages/

Using Outbrain Select Articles as Blog Posts:
  • To share syndicated pages in your post feed as entries there is another plugin that can help. Once You've posted an article and it has been pushed to FB, LinkedIn, Twitter; you can follow those links to get the real URL of those syndicated pages. Then, create a new blog post with its own title and using the redirect plugin below, it will go directly to that article within your site. That plugin is called "Quick Page/Post Redirect" and the site is: http://www.fischercreativemedia.com/plugins/quick-page-post-redirect-plugin/