How do I use Letterhead's WordPress Plugin?

Letterhead's WordPress Plugin allows you to publish WordPress posts automatically into your newsletters. If you have a WordPress website and curate articles from your site, this article is for you.

Our customers want and need more efficient and effective ways to get content into Letterhead newsletters, so we have introduced our WordPress Plugin.  You are now able to automatically push published WordPress posts and their metadata into Letterhead and automate sharing WordPress content through newsletters with a WordPress composer block.

Installing the Plugin on your WordPress site

1. Login to your WordPress site.
2. Select Plugins from the menu on the left-hand side of the screen.
3. Click Add New
4. Download our Letterhead Wordpress Plugin file from the Organization-level Settings -> Integrations page.
5. Upload the zip to your Wordpress website to install.
6. Once installed, enter the API Key for your brand and click Save.  Click here to see where to find it.
7. Once you have saved, choose the channel to sync with your site and make sure to select Yes under Curations sync.

Setting up your newsletter to load stories or posts from your  WordPress site

1. Open your existing template or create a new onw, by going to the Newsletters screen and selecting Templates to edit or create a new template.
2. Once you have deactivated the template you would like to edit, or started from a blank one, go to the blocks on the right of the screen.
3. Scroll to the bottom of the block menu, until you get to the Integrations section, then click the drop down.
   
   
4. Click and drag the WordPress block to the composer.
5. Once the WordPress placeholder is visible in your newsletter, click on it, and the block settings will slide out on the right of the screen.
6. You'll see the following options displayed:
   1. Search: enter a search term and load published articles that include that term or headline.
   2. Source: limit articles to those from specific sources
   3. Tags: limit articles to those with a specific tag
   4. Date curated: limit articles by date.
   5. Number of items: display a specific number of articles
   6. Skip: skip a certain number of articles from loading.
   7. Layout Items: adjust the image and text placement within the block.
   8. Display options: This allows you to adjust the display options according to the data available from your source.
      
      
      
   9. Boarder: This setting applies to the block itself and not the content contained within the block.
      
   10. Color: update the background color of your WP block, in order to have it stand out, click on the color to update it.
       
   11. Fonts: update the font settings within this block.
   12. Padding: adjust the spacing within the block.  You can add or reduce spacing from the newsletter margins or between the blocks above or below this one.

Loading Articles in the Newsletter

If you are working on a template draft, once you have updated all the settings, you can click on the 'X' at the top of the block settings to exit out of the Wordpress block, and reactivate your template.

1. Once your template is active, go to the Newsletters screen. 
2. Click Use template to use the template you recently updated with the Wordpress placeholder.
3. When the newsletter loads, click on the Wordpress placeholder to view the block settings.
4. Once the block settings are visible, click on the Load button visible towards the middle of the block settings, just below the Skip setting.
5. After clicking the Load button, you will see the WP articles load in the composer section of the screen and they will replace the placeholder.