Largo version 0.6.4

Largo 0.6.4

This release brings improved compatibility with the WordPress Block Editor. The Pull Quote block gains full styling, so that block quotes and pull quotes no longer appear the same. Media credits are now output on Image blocks.

The Largo Series Posts Widget gains more options for the display of images.

Largo gains support for the wp_body_open hook, introduced in WordPress 5.2.

This release also contains a number of bug fixes and minor updates.

For information on how to upgrade your own Largo-using website, see our newly-updated documentation for upgrading Largo. If you're a Largo user, we encourage you to say hi, either by email to labs@inn.org or via our handy-dandy contact form.

Particular thanks go to outside contributor @megabulk.

Developer-facing improvements

• Adds largo_category_after_primary_featured_post hook between primary and secondary featured posts on the category.php template. Pull request #1703 by @megabulk.
• Adds largo_series_before_stories hook before stories on the series-landing.php template. Pull request #1703 by @megabulk.
• Adds largo_archive_before_stories hook before stories on the archive.php template. Pull request #1703 by @megabulk.

Fixes and minor improvements

• Updates largo_home_single_top function to get homepage_feature_term and top_story_term values from slug instead of by name. If these prominence names were updated to anything else, homepage_feature_term and top_story_term would be false and fallback to __('Homepage Featured', 'largo'). Pull request #1709 for issue #1445.
• Removes separator <span> on search results page; puts the search result url on a new line instead of next to the date. Also adds a overflow-wrap: breakword; style to the search-result URL to make sure it doesn't overflow the result container. Pull request #1710 for issue #1509.
• Fixes a ReferenceError in navigation menu JavaScript. Pull request #1715 for issue #1714.
• Fixes an undefined variable error in certain edge cases of the site og:description and description meta tags. Pull request #1724 for issue #1721.
• Co-Authors Plus profile field descriptions no longer contain escaped HTML. Pull request #1726 for issue #1720.
• Added box-sizing: border-box; style attribute to figcaption and .wp-caption-text elements to prevent caption text from overflowing from the parent container. Also modified Gutenberg block image caption styling to be consistent with the classic image caption styling when the image is expanded into a lightbox. Pull request #1711 for issue #1702.
• Fixes multiple Undefined variable: post errors in homepage/templates/top-stories.php. Pull request #1728 for issue #1723.
• Fixes an issue where the widget title wasn't displaying in the Largo Image Widget, due to trying to use the $title variable which was removed when we stopped using extract in pull request #1565. Pull request #1736 for issue #1717.
• Added support for wp_body_open hook below opening body tag. Pull request #1735 for issue #1698.
• Added font-display: block to fontello font family. Pull request #1742 for issue #1686.
• Replaced image settings in the Largo Series Posts widget to mirror the image settings in the Largo Recent Posts widget. Pull request #1734 for issue #1727.
• Adds a temporary shim to fix left/right aligned images not being correctly aligned with paragraphs. Pull request #1747 for issue #1731.
• Fixed an issue where the Largo specific media credit caption and url was not being output in Gutenberg image blocks. Pull request #1733 for issue #1683.
• Updated pull quote block styles so they can be easily differentiated from regular block quote blocks. Pull request #1746 for issue #1699.
• Fixed an issue where clicking on an image in an open slideshow modal resulted in the image having a different width once the modal was closed. Pull request #1743 for issue #1700.
• Fixed an issue where setting the sticky navigation to show at the top of the page didn't output the expected result. Pull request #1662 for issue #1660.

Upgrade notices

Since 0.6.3:

• If your site has replaced or modified Largo's navigation.js, you may want to reassess that in light of the changes made in #1623 and #1715.

If you are upgrading from a version of Largo before 0.6.3, you should check prior versions' release notes.

Largo version 0.6.3

Largo 0.6.3

A short release this time around, but one that we thought needed to be released.

If you haven't already, please read the version 0.6.2 release notes.

Fixes

• Fixes several issues with magnification behavior of images. Pull request #1695 for issue #1664

Largo version 0.6.2

Largo 0.6.2

This release brings improved compatibility with the WordPress Block Editor. The CSS class names type-pull-quote, alignleft, alignright, aligncenter and half provided by Largo's "Module Wrapper" function in the Classic Editor are now supported on blocks via the "Additional CSS Classes" control, enabling improved pull quote display.

This release removes support for Google Plus, which shut down on April 2, 2019.

This release also contains a number of bug fixes and minor updates.

Particular thanks go to outside contributors @seanchayes and @megabulk.

Feature updates

• Adds support for responsive embedded content, which is most noticeable with video content set to full width. Pull request #1689 for issue #1688.
• Image and embed blocks aligned left/right, on viewports that are too small to display them reasonably in the indicated position, become 100% width of the column and lose their alignment. Pull request #1630 by @seanchayes for issue #1611.
• Matches the default styles for Gutenberg's Quote block with Largo's styles for <blockquote>. Adds styles for <cite> elements. Pull Request #1687 for issue #1682.
• Ensures that the CSS classes used by Largo's Classic Editor plugin "Module Wrapper" can be used on pull quotes. Pull Request #1687 for issue #1682. If you'd like to make use of these classes by adding them to a Pull Quote block in the "Additional CSS Class" control of the "Advanced" section of the pull quote's block settings, the list of classes is as follows:
  • type-pull-quote: appears larger in the story, with a slightly fancier presentation
  • alignleft: block is aligned left. This class may make it impossible to select the block in the editor with your mouse, requiring use of the keyboard to move the cursor into the block.
  • alignright: block is aligned right. This class may make it impossible to select the block in the editor with your mouse, requiring use of the keyboard to move the cursor into the block.
  • aligncenter: block is aligned center.
  • half: Block is half the width of the column at all but the smallest screen widths.
• Removed all Google+ profile fields in the admin interface and buttons on the front-end due to Google+ being shut down on April 2, 2019. Pull request #1667 for issue #1546.
• Prevents search engine indexing on 404 and search results pages. This change is to keep up with SEO best practices, to preserve your crawl budget with Google, and to prevent a SEO hijacking attack whereby spammers search for their URL on your site, then get the resulting search query result page listed in search engines using your site's reputation. Pull request #1674 for issue #1615.
• Updates INN's logos in the img/ folder. If your child theme redefines the function inn_logo(), please update that function to reference the new SVG image locations in img/. Pull request #1633 for issue #1621

Function updates

• Adds the term's taxonomy slug and term slug in the format taxonomy-term as a class on the term in the output of largo_top_term(), largo_category_and_tags(), and largo_maybe_top_term(). Pull request for issue #1646.
• The arguments set on largo_byline() are now passed to the largo_byline filter as an array of argument name => argument value. Pull request #1657 for issue #1646.
• Makes the function largo_get_term_meta_post() pluggable. Pull request #1666 by GitHub user @megabulk.
• Widget area name is now output as an HTML comment on many sidebars, to ease debugging widget presentations. Pull request #1632 by @seanchayes for issue #1492.
• Added note to category.php template explaining how to modify displaying the featured posts on category pages. Pull request #1676 for issue #1595.
• Upgrades ReadTheDocs build process. Pull request #1680 for issues #1616 and #1456.
• If Co-Authors Plus is active, and if a post has an author term, but the term has no corresponding guest-author post, when running largo_byline(), the byline will now contain an HTML comment informing why the byline is empty. If the WP_DEBUG or LARGO_DEBUG constants are true, Largo will add a message to the server's error log of the form "post 123 should have at least one co-author, but has none!" Pull request #1607 for Automattic/Co-Authors-Plus#637 and as part of the general cleanup ticket #1492.

Fixes and minor improvements

• Defines a new image size 96x96 for use on avatars and small square listing images. This is a bug fix; Largo has referred to such an image size for a long time but never made sure that such images existed. Sites worried about this issue may want to regenerate thumbnail images. Pull request #1672 for issue #1619.
• Increases contrast of the floating social button icons against the background, to improve accessibility. Pull request #1635.
• Fixes issue where floating social buttons were not clickable, because of z-index ordering. Pull request #1635 for issue #1576.
• Fixes links in social media buttons not respecting the blog's character set. Pull request #1635 for issue #1283.
• Fixes issue where [module]content[/module] was not rendering content in the output of the largo_module_shortcode() function. Pull request #1645 for issue #1639.
• Function largo_post_social_links now respects the blog character set option. Pull request #1635 for issue #1283.
• Fixes PHP notices in class Bootstrap_Walker_Nav_Menu. Pull request #1624 and #1625 for issue #1623 as part of issue #1492.
• Fixes a regression in the behavior of the Largo Follow widget in Largo 0.6. Pull request #1600 for issue #1599.
• Fixes issue where post excerpt and featured media were not being used for open graph tags on post types that are is_singular() but not is_single(). Pull request #1604 for issue #1602.
• Prevents largo_top_term() from calling largo_category_and_tags() when the post ID argument passed to largo_top_term() does not match get_the_ID's post ID, because there is presently no way to pass that ID to largo_category_and_tags(). Pull request #1648 for issue #1647.
• Fixes improper post ID argument passed to largo_top_term() in the homepage featured stories zone. Pull request #1648.
• Removes duplicate site title in opengraph tags for non-archive, non-is_front_page(), non-is_singular() URLs. Pull request #1604 for issue #1602.
• Removes search form from global nav bar when on the search page, so that there's only one search form. Pull request #1604.
• Cleans up the search page when no query has been entered. Pull request #1604 for issue #1603.
• Defines the index 'class' in partials/widget-content.php when using a large image. Pull request #1606 for issues #1605 and #1492.
• Fix for posts with "Featured in category" selected not displaying on category RSS feeds. Pull request #1668 for issue #1598.
• Fixes issue where prominence terms were not saving with the Block Editor, because the "Post Prominence" metabox was output twice. Pull request #1655 for [issue #1...

Largo version 0.6.1

This release contains bugfixes for Largo 0.6, and improved compatibility with the Gutenberg block editor.

INN Labs blog posts accompanying this Largo release:

• The Largo 0.6.1 release announcement
• How to update your site from Largo 0.5.5.4
• What you need to know about Gutenberg and how it'll benefit your newsroom

Changes

• Uses filemtime() as the version number for more enqueued assets, meaning that cachebusting will be handled by file modification time and not by Largo version. Pull Request #1575 for issue #1550.
• For many assets where no version number was provided for enqueued assets, largo_version() is now used. Pull Request #1575 for issue #1550.
• Removes the list of recommended plugins displayed on new installations of Largo. Pull Request #1580 for issue #1570. This list now lives at https://support.inn.org/article/163-recommended-wordpress-plugins

Fixes

• Updates templates to make sure that bylines are output. Pull request #1574.
• Fixes a division-by-zero bug in avatar functions. Pull request #1578 as part of issue #1492.
• Allows the Largo Taxonomy List Widget to have an empty title. Pull request #1583 for issue #1581.
• Allows the Largo Recent Posts Widget to have an empty title. Pull request #1588 for issue #1405.
• Makes sure that the series, post type, and post prominence taxonomies appear in the REST API and in the Gutenberg editor. Pull request #1586 for issue #1582.

Documentation and administrative improvements

• Lays groundwork for testing Largo under PHP 7.3. Pull request #1587 for issue #1579.
• Adds a pip requirements.txt for Sphinx dependencies required by Grunt tasks used during the development process. Pull request #1585 for issue #1359.
• Removes several unneccessary Grunt tasks from the Gruntfile, and their dependencies. Pull request #1585 for issue #1540.
• Removes some old developer setup instructions from the largo.readthedocs.io setup instructions. Pull request #1585.

Largo version 0.6

Largo version 0.6

This release of Largo provides support for Gutenberg, the star feature of WordPress 5.0. It prevents social media metadata duplication when using the Yoast SEO plugin. And this new release contains a number of bug fixes and performance improvements.

Special thanks to our community contributors:

• Mike Schinkel for his work on pull request #1469 at WordCamp for Publishers 2017's Contributor Day.
• GitHub user fenriz07 for their work in PR #1541 on updating links in our documentation.

If you're using Largo on your site, say hi! Send us an email at labs@inn.org or through the contact form, sign up for a slot in our weekly open office hours, or just say hi to our staff at a conference. We'd love to include you on our list of sites using Largo.

New Features

• Adds Gutenberg support, with:
  • editor styles
  • support for the .alignwide and .alignfull CSS classes and their use in blocks
  • pullquote styles

Changes

• Fixes numerous undefined variable errors, as part of issue #1492.
• Users who have the capability to edit a given post will see the edit link on the frontend, where before users with the capability to edit published posts in general saw the link to edit the post in the frontend. PR #1559 for issue #1543.
• Largo now uses WordPress' title-tag support for <title> tag output, which means that site title tags shoud now be modifiable by plugins. PR #1566 for issue #1470.
• If the Yoast SEO plugin is active, Largo's default Open Graph Protocol and Twitter Cards tags will not be output. PR #1567 for issues #1437 and #1470
• Adds support for WordPress' .screen-reader-text CSS class. PR #1530 for issue #1528 as part of issue #844.
• Updates .visuallyhidden CSS styles in accordance with the latest recommended technique. PR #1530 for issue #1528 as part of issue #844.
• Thins the homepage stylesheets with LESS (reference) imports. PR #1530 for issue #1528 as part of issue #844.
• Adds a text domain to style.css. PR #1527 as part of issue #844.
• Fixes a "WP_Admin_Bar::add_node was called incorrectly" warning message. PR #1504 for issue #1349.
• Modernizes Travis CI configuration to cover PHP 5.6, 7.0 and 7.1, and WordPress 4.6 through 5.0. Drops support for PHP 5.5 and earlier and WordPress 4.5 and earlier. PR #1503 and #1554.
• Where largo_remove_hero() removed duplicate hero images from the top of the_content(), the function no longer outputs empty paragraph tags, and now works on img tags without src="" attributes. PR #1503 for issue #1404.
• Alphabetizes the contributor list in readme.md.

Removed

• Deprecates largo_fb_user_is_followable(), because Facebook changed their API.
• Removes the default inclusion of Google Analytics with INN's Largo Project IDs. PR #1502 as part of issue #1495, and by request.
• Removes the INN Member RSS widget, because the RSS feed it draws from is no longer supported or maintained by INN. Because the RSS feed was occasionally empty, the widget would result in 500 errors. RP #1535 for issue #1511 and #893.
• Removes lingering traces of the Largo Featured Widget. PR #1563 and #1469 for issue #1467, from Github user mikeschinkel.
• Removes many uses of extract() in widgets and theme functions, and improves code quality in widgets.
• Removes uses of screen_icon() and get_screen_icon(), deprecated in WordPress 4.8. PR #1523 for issue #1523 as part of issue #844.
• Removes the <title> element from header.php, since Largo declares title-tag theme support. PR #1566 for issue #1470.
• Removes two remaining PHP short tags. PR #1525 for issue #844.
• Removes some deprecated style.css metadata tags. PR #1524 for issue #844.
• Removes Hipchat support from .travis.yml. PR #1503.

Upgrade notices

• If your child theme has significant custom styling, or has custom post templates, your theme may need to provide additional styles to ensure Gutenberg compatibility.
• A future version of Largo will require the third parameter of largo_byline() to be specified in all calls. PR #1561 for issue #1517 adds code that, in testing environments with WP_DEBUG or LARGO_DEBUG set to true, will result in server log messages. This is necessary to prevent mismatches between the Loop's global $post and the desired byline output. The third parameter of largo_byline() may be a WP_Post instance or a post ID. Example call: largo_byline( true, false, get_the_ID() );.

Largo 0.5.5.4

This is a maintenance release containing bug fixes for v0.5.5.

This release breaks compatibility with PHP versions before 5.5: https://github.com/INN/largo/pull/1407/files#r105924102 If you are still using PHP 5.5 or earlier, please be warned that they no longer receive security patches: https://secure.php.net/eol.php

• Updates some minor documentation
• Fixes a bug where using an image gallery on a post caused the post to scroll to the gallery upon page load (8acc31d)
• Fixes a bug where the current post was included in a list of related posts for the current post (#1403)
• Fixes an undefined warning regarding meta boxes (#1408 for #1406)
• Fixes several undefined notices in featured media functionality (#1350)
• Cleans up inc/helpers.php (#1407)
• Reorders the featured media dialog's UI from "Embed, Video, Image, Gallery" to "Image, Gallery, Video, Embed" (#1408)

v0.5.5.3

Largo 0.5.5.3

Maintenance release containing bug fixes for v0.5.5

Features

• Removed a MySQL query that was causing unnecessary server load.
• Removed var_log() function calls creating errors
• Updated Largo update notification to rely on the update_themes capability
• Added thumbnail to featured image meta box on post edit screen
• Show byline separator on single post pages
• Retain sort order when opening featured media gallery modal window
• Added the lightbox view to single images
• Made the gallery/grid-view setup more user-friendly and consistent

v0.5.5.2

Largo 0.5.5.1

Maintenance release containing bug fixes for v0.5.5

Features

• Removed a MySQL query that was causing unnecessary server load.

Largo 0.5.5.1

Largo 0.5.5.1

Maintenance release containing bug fixes for v0.5.5

Features

• Fixed issue with related posts widget sometimes displaying current post (duplicating the display)
• Fixed status notification issue when upgrading Largo
• Reverted visual updates made in v0.5.5 to display post Updated Date by default. These are now available via a hook.
• Fixed issue with class variables not correctly printing
• Fixed front end errors displaying in comments.
• Made twitter widget scrollable.
• Minor code cleanup

v0.5.5

Largo 0.5.5

This is expected to be the last release in the 0.5.x codebase. The next version of Largo is anticipated to be a major change, and may not maintain compatibility or continuity with the INN/Largo repository.

Documentation

The project website (largo.inn.org) is now the home for user-facing and admin-facing docs. Developer-facing docs remain at largo.readthedocs.io

Features

• Set Featured Media Button has moved from above the post editor to a new metabox (#1323 and #1285 for #698)
• Adds support for TinyMCE’s underlining and text color buttons, while removing Heading 1 (#1295 for #790, #1296 for #670)
• A new design for the gallery slider (#1307)
• Enable displaying the sticky nav on all pages (#1262, #1266, and #1269 for https://github.com/INN/Largo/issue/1260, #1286)
• Improvements to search pages including cleaner styles, shorter excerpts, the publish date and the URL of the post, and new actions in Google Custom Search Engine and non-GCSE searches. (#1167 for https://github.com/INN/Largo/issue/1162, #1177, #1237 for #1235)
• Improvements to 404 pages, now including the query string that resulted in the 404 to aid in searching. (#1168 for #692)
• Adds “Job Title” to the list of fields that Co-Authors Plus allows guest authors to have (#1098 for #1097)
• Adds job title to the output of largo_byline() with and without Co-Authors plus enabled, but does not link it to the author’s byline page (#1098 for #1097)
• Adds the option to hide the email address of a Co-Authors Plus guest author in the author bio partial, which is used in the Largo Author Bio widget and the posts-by-author archive. (#1098 for #1097)
• A number of changes to the Largo Related Posts widget, including removing the option for placing the image before or after the headline and making the “Show byline” checkbox work (#1243 for #1242)
• A revised Largo Taxonomy List widget, including the ability to exclude terms, limiting output of related terms to 5 or fewer, making the “taxonomy” chooser into a <select> box, and adding the ability to sort alphabetically by term name or by newest term first (to fix a performance issue where it was outputting infinite terms) (#1187)
• Supports a “None” option for top term, allowing posts to have no top term set (#1090 for #1082, #1094)
• Posts that have been updated now display the updated date/time at the top of the post. This creates a new function largo_edited_date() which displays either the time since updated or the date of update. (#1343 for #1341)
• Adds the Largo post-type taxonomy to the list of taxomomies that can be chosen for a post’s Top Term. (#1086 for #1084)
• Ads are now horizontally centered within ad zones (#1093)
• Improved Homepage Alert widget styles (#1095)
• Adds Instagram and Pinterest as supported social networks (#1099)
• Largo’s Floating Social Buttons are now enabled in the two-column post template and in custom templates for single posts (#1102)
• Add a option to the Largo Recent Posts widget to toggle the presence of the publish date in the byline (#1364)
• Add a new widget area “Header Widget” in the header, floated to the right and limited to 320px wide. This is controlled by a checkbox in Theme Options > Advanced, and is best used for a newsletter signup or a donation call-to-action. (#1114 for #1038)
• Improved support for Link Roundups in archives of posts (#1122)
• Adds support for Largo-style featured media to the two-column classical layout (#1140 for #934)
• Removes the WordPress custom image sizes options page, because Largo forces these image sizes and the settings page has no meaning (#1218 for #404)
• Removes the Largo Explore Related widget, which was already deprecated and was breaking slideshows in posts that had categories. (#1241 for #1240)
• Removes the sidebar from the single-post single-column template, to match documentation. It shouldn’t have been showing up there. If you wish to display widgets in the single-column template, may we recommend the Super Cool Ad Inserter Plugin? (#1292 for #1104)
• General style cleanup and improvements

Bugfixes

• Social media buttons are now translatable (#1153)
• Uses esc_url instead of esc_attr to escape URLs passed to the Twitter and Facebook Share functions (#1077 for #1076)
• Better fallbacks in largo_top_term for posts with no top term set but top term display not set to “None”: attempt to display the category, the tags, and finally the post-type. (#1094)
• Better fallbacks for the via attribute of the Twitter share link in post social media buttons, including supporting the Twitter accounts of Co-Authors Plus guest authors. (#1107 for https://github.com/INN/Largo/issue/1088, #1118 for #1117)
• Removes friend@example.com from mailto: links in share buttons, and removes the JavaScript requirement for the email functionality (#1192 for #799, #1281 for #799)
• Properly escapes post titles in the Twitter and Facebook share links (#1121, #1147 for #1134)
• Job titles are not output in bylines if the Largo custom byline text is set for a post (#1109 for #1108)
• Remove date duplication in the Recent Posts Widget (#1111 for https://github.com/INN/Largo/issue/1110)
• If an author does not have a first name set in their profile, the “More by ___” text uses “More by this author” (#1112)
• Actually respect the output of the largo_post_social_links filter (#1142)
• Don’t display “Page Not Found” language on categories with a hierarchical header and fewer than 5 posts (#1270 for #898)
• Post Prominence terms created by users are now available in post add/edit screens (#1255 for #956)
• Switch Travis to using a Facebook user that doesn’t exist, after someone created an account using the name abcdefghijklmnopqrstuvwxyz12 (#1234 for #1233)
• Adds a title for /?post_type= archives using archive.php (#1232 for #1231)
• Strip HTML tags from og: Open Graph tag contents (https://github.com/INN/Largo/pull/1279/files)
• A fix for the Don’t Miss menu’s label not displaying correctly (#1284 for #1083)
• Un-hides posts that were being skipped in the Recent Stories list (#1287 for #1219)
• Better detection of no related topics in partials/archive-category-related.php, which means that largo_get_related_topics_for_category() outputs an empty string if there are no related topics (#1289 for #1288)
• The update nag is no longer shown on fresh installs of Largo (#1363 for #690)
• In the Homepage Bottom Widget Area homepage bottom partial, $wp_query->posts is now temporarily an empty array for the duration of the partial (#1354)
• Sticky navigation now supports menus named “More” (#1339 for #1336)
• Largo_Related now uses a modern tax_query for some queries, and uses the correct slugs for the Tag and Category taxonomies (#1338)
• Replacing showposts with posts_per_page throughout (#1313)
• Replace get_currentuserinfo with `wp_get...