Merge branch 'master' into develop, rebuild translation files and CSS

- This uses the copy of lang/es_ES.po from master instead of merging
- Rebuilt translation files with `grunt pot shell:msmerge`
- Rebuilt css with `grunt less cssmin`
- Resolves conflict in `searchform.php` from difference between \#1168 and \#1167

404.php

@@ -9,6 +9,21 @@
 
 <div id="content" class="span8" role="main">
 	<?php get_template_part( 'partials/content', 'not-found' ); ?>
+	<?php
+		/*
+		 * Display the Recent Posts widget
+		 *
+		 * @since 0.5.5
+		 * @link http://jira.inn.org/browse/WE-103
+		 * @link https://codex.wordpress.org/Function_Reference/the_widget
+		 */
+		if ( class_exists( 'largo_recent_posts_widget' ) ) {
+			the_widget( 'largo_recent_posts_widget', array (
+				'title' => __( 'Or check out some of our recent stories', 'largo' ),
+				'show_byline' => 1
+			));
+		}
+	?>
 </div><!--#content -->
 
 <?php get_sidebar(); ?>

docs/api/inc/post-tags.rst

@@ -1,6 +1,13 @@
 inc/post-tags.php
 =================
 
+.. php:attr:: $output
+
+      Filter the output text of largo_post_social_links() after the closing </div> but before it is echoed or returned.
+
+      :since: 0.5.3
+      :param string $output: A div containing a number of spans containing social links and other utilities.
+
 .. php:function:: largo_trim_sentences()
 
    Attempt to trim input at sentence breaks

docs/api/inc/sidebars.rst

@@ -41,4 +41,20 @@ inc/sidebars.php
 
 .. php:function:: largo_is_sidebar_required()
 
-   Determines if is_single or is_singular context requires a sidebar
+   Determines if is_single or is_singular context requires a sidebar
+
+.. php:function:: largo_header_widget_sidebar()
+
+   Output the "Header Widget" sidebar
+
+   :action: largo_header_after_largo_header
+
+   :since: 0.5.5
+
+.. php:function:: largo_post_bottom_widget_area()
+
+   Output the "Article Bottom" sidebar
+
+   :action: largo_header_after_largo_header
+
+   :since: 0.5.5

docs/users/posting.rst

@@ -4,80 +4,103 @@ Writing Posts
 Formatting Within Posts
 -----------------------
 
-After you have entered the text for your post you are able to create asides and pull quotes as well as add media to your post.
+As you create a post you can add formatting and enhance it in various ways. 
 
 **Module Wrapper**
 
-Within in the body copy box, using the visual editor you can access the module wrapper options by clicking on the icon furthest to the right.
+The module wrapper allows you to make a selection of text appear as an aside or a pull quote. To use it, select some text in Visual mode and click the Module Wrapper icon which is the furthest to the right in the formatting tool bar. You can then select:
 
-The module wrapper enables you to make a selection of text appear as an aside or a pull out quote.
+* Aside, which pulls the text aside and wraps the other post content around it. This similar to a pull quote but with undecorated text.
+* Pull Quote, which also pulls the selected text aside and applies styling to make it stand out from the body text.
+* Embedded Media, which is useful for videos and other embedded content to make them resize responsively for different screen sizes. 
 
+Use the module wrapper options to align your selection left, right, or center, and to display half-width or full-width. In the case of embedded content, you can choose to extract the width from the embed code itself but this will prevent it from resizing responsively.
+
+*Tip: Preview the post to see how the module wrapper will display your content. You can use `undo` to revert changes made by the module wrapper, or by using Text mode you can delete the HTML wrapped around the selected content.*
 
 **Add Media**
 
-The Add Media button above the body copy box allows you to upload images and insert images of various sizes into posts.
+The Add Media button above the body text area allows you to upload and insert images of various sizes anywhere in a post:
+
+- Place the cursor where you want an image to appear in the text.
+- Click the Add Media button, and either select from the existing Media Library or upload a new image.
+- In the Insert Media screen, you can add a Caption, Description, Credit, Credit URL, Organization, and Alt Text. Alt Text is very important for meeting accessibility requirements and serving visually-impaired users.
+- Also in the Insert Media screen, you can set the image alignment, add a link from the image, and set the image to full-size, medium, or thumbnail.
+
+In addition to inserting images in posts, you can also add:
+
+- Photo Galleries
+- Audio Playlists
+- Video Playlists
 
+Note that uploads of media files are limited to 50 MB per file. In most cases it's better to embed videos rather than uploading them to a playlist.
+
+Once an image or other media element is added to a post, you can click on it to edit as needed.
 
 **Featured Media**
 
-The Set Featured Media button is located above the body copy box.
+Featured media can more deeply engage your audience by getting their attention the moment they view the story page. A strong image or video also increases sharing on social networks and extends the reach and impact of your work. And images and other media are important elements in telling a story.
 
-In this window you can select featured media: embed code, video, image or gallery of images to appear in the hero section at the top of the article.
-The featured media may also appear on the homepage (see Post Prominence below).
+The standard WordPress site allows you to add a featured image to display at the top of each story page, as a thumbnail for each post on the homepage, etc. Largo extends this by allowing you to feature not just static images, but many kinds of media content (video, slideshows, and other embedded media).
 
+Featured media will display at the top of the post page between the byline and the main text. For best visual results use a landscape-shaped image (or other media) with a width of 1170px.  Featured images will also display as cropped thumbnails on the home page or section page associated with the post. Note that featured videos, embed codes, and galleries will not display a home/section page thumbnail.
 
-Other Post Options
-------------------
+To add featured media, in the edit screen of your post click the Set Featured Media button. This opens a modal window where you have some options:
 
-After you are finished with the body of the post, there are a number of additional options to consider.
+- You can enter embed code from any type of embeddable content. If you add a Title, Caption, and Credit, they’ll appear along with the embedded media.
+- Featured video allows you to enter a Video URL from YouTube, Vimeo, or another video hosting service. If the embed code is not pulled in automatically you can enter it in the Video embed code field. You can add a custom thumbnail image for display on the home/section page, but note that the custom thumbnail won't display on the post page in place of the video itself.
+- Featured image is typically used to include a "hero" image at the top of the post. For best results use a landscape image with a width of 1170px. 
+- Featured gallery enables you to build a carousel of images. Select multiple images from the Media Library, or upload new images to use in the gallery. 
 
+When uploading images you can click the Select Files button in the Upload Files tab, or just drag and drop images into the modal window. When using images for any purpose, make sure to add Alt Text to meet accessibility requirements for visually impaired website users. 
 
-On the right sidebar of the Post Edit Screen you will find:
+With all featured media you can add a title, caption, and other descriptive information for display with the media on the post page.
 
-**Taxonomies**
 
-The taxonomies activated by default include Categories, Tags and Post Prominence. Additional there are two optional taxonomies (Series and Post Types) that are enabled through the Appearance > Theme Options > Advanced menu. More about taxonomies http://largo.readthedocs.org/users/taxonomies.html
+Taxonomies
+------------------
 
+Taxonomies are a way to label and organize the posts on your site. Taxonomies activated by default in Largo include Categories, Tags, and Post Prominence. Two optional taxonomies, Series and Post Types, can be enabled through the Appearance > Theme Options > Advanced menu. 
 
-**Related Posts**
+Taxonomies do two important things:
 
-Managed by the Largo Related Posts Widget
-Show related posts that are either editorially determined (by adding related post IDs in the Additional Options box of the post edit screen) or using a default related algorithm that tries to surface the most closely-related post(s) to a given post by series, category or tag.
+- They add good metadata for search engine optimization and social media.
+- They allow sorting of content on landing pages and widgets based on topic or content type.
 
-To override the default related posts functionality enter specific related post IDs separated by commas.
+The way Largo handles taxonomies is explained in detail on the Largo `Taxonomy documentation page <taxonomies.html>`_.
 
-To find the post id, from the post menu, click on the post you are looking to identify.
-http://example.com/wp-admin/post.php?post=1280&action=edit
-The Post ID  is 1280.
+**Categories, Tags, and Series**
 
+After creating the body of the post, you should assign some Categories and Tags to it. If you are using the Series or Post Type taxonomy, assign the post to the relevant series and/or post type.
 
-**Top Term**
+**Related Posts**
 
-From a pulldown menu (populated by categories and tags) Identify which of the post's terms is primary. This is used a navigational aid in many homepage layouts and appears directly above the headline on the single article template.
+If you are using the Largo Related Posts Widget, you can add selected related posts by entering one or more post IDs separated by commas. To find the ID of a post, open it as if you were editing the post. In the browser address bar you'll see a number in the URL similar to _http://yoursite.org/wp-admin/post.php?post=31400&action=edit_. In this case 31400 is the post ID. 
 
+_Note: If you are using the Largo Related Posts Widget and don't add related posts to any given post, the widget will display related posts based on series, category, or tag._
 
-**Custom Byline Options**
+**Top Term**
 
-The recommended author options include: Creating a WordPress account for each author, or  if you need to include co-authors, activate the Co-Authors plug in.  More plugin information http://largo.readthedocs.org/users/plugins.html
+From the Top Term pulldown menu (populated by categories and tags) select which term is primary for the post. This term appears directly above the headline on the post page, and links to the landing page for all posts assigned that top term.
 
-In rare instances you can enter plain text to override the byline by entering the text of the byline as you want it to appear and where you would like it to link to (because WordPress will not automatically create an author archive page as it does for regular users) into the custom byline text and byline link boxes.
+**Custom Byline Options**
 
+If you are posting for an author who doesn't have a WordPress user account for your website, you can enter their byline and optionally a link to a relevant webpage for that author. 
 
-**Layout Options**
+We recommend creating a WordPress account for each author, which allows WordPress to create an author archive page with all posts for each author. If you find that you need to include co-authors, you should activate the `Coauthors Plus plugin <plugins.html>`_. 
 
-The default post template since Largo 0.4 is the One Column (Standard) layout. In this box you are able to modify the template on a per-post basis by selecting another option.
+Using the Custom Byline Option will override display of the user entering the post, and will not add the post to an author archive page.
 
-More about the Single Article Template
-http://largo.readthedocs.org/users/themeoptions.html#layout-options
+**Layout Options**
 
+The default post template since Largo 0.4 is the One Column (Standard) layout. In this box you can choose a different layout for the post. Read more here about the alternative `post layout options <themeoptions.html#layout-options>`_.
 
 **Custom Sidebar**
 
-The default (single column) post layout does not include a sidebar. If you select a sidebar from this dropdown menu it will be displayed as a skinny column directly to the left of the post beginning below the hero image.
+The default (single column) post layout does not include a sidebar. If you select a sidebar from this dropdown menu it will be displayed as a column on the left of the post beginning below the hero image.
 
 For the two column post template, the sidebar is displayed to the right of the main post content.
 
+**Post Prominence**
 
-**Sticky Footer**
-
-The sticky footer at the bottom of the post in Largo 0.4 displays share icons for Twitter, Facebook and email on the left and follow on the the right with links to other stories in the same category or written by the same author. You can toggle the option to display the various social networks from the Appearance > Theme Options menu.
+This is used to determine how and where posts are displayed on the site (for example, top stories on the homepage or featured content widgets in a sidebar or footer). For more on Post Prominence see the `Taxonomy documentation page <taxonomies.html#post-prominence>`_.