Release 2021.001 - HL Vanilla Community
<main> <article class="userContent"> <p>N.B. This release includes some updates to our theming engine. If you have customized your own Vanilla theme and applied custom CSS, please see the <a href="https://success.vanillaforums.com/kb/articles/364-release-2021-01#theming-engine-changes" rel="nofollow noreferrer ugc">Theming Engine Changes</a> section of these notes. </p><h2 data-id="schedule">Schedule</h2><p>Release 2021.001 will be released:</p><ul><li>To staging sites Tuesday, January 12th 2021</li><li>To production sites Monday, January 18th 2021</li><li>To Enterprise clients Monday, January 25th 2021</li></ul><h2 data-id="advanced-theming">Advanced Theming</h2><p>Vanilla releases 2020.001 - 2020.006 will have a strong focus on improving the advanced theming capabilities of our Foundation theme and our theme editor.</p><p>This release brings the first step of that, with a new "Advanced Settings" section of the theme editor. This brings a JSON variable editor and inline documentation for 100s of variables that are not currently included in the visual user interface. Undocumented variables can also be used here and more documentation will be added in the future.</p><h3 data-id="the-advanced-variables-panel">The Advanced Variables Panel</h3><p>Open the variables panel by clicking on the new "Advanced Settings' button at the bottom of the theme editor. Changes made in this new menu will sync back and forth between the visual editor and the advanced editor.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://user-images.githubusercontent.com/1770056/104071548-650b7400-51d7-11eb-9809-e1bb479fe499.gif" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://user-images.githubusercontent.com/1770056/104071548-650b7400-51d7-11eb-9809-e1bb479fe499.gif" alt="Untitled Image" height="489" width="1000" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h3 data-id="inline-documentation">Inline Documentation</h3><p>Inline autocomplete and documentation has been added for the following sets of variables:</p><ul><li><code class="code codeInline" spellcheck="false" tabindex="0">banner</code> </li><li><code class="code codeInline" spellcheck="false" tabindex="0">titleBar</code> </li><li><code class="code codeInline" spellcheck="false" tabindex="0">userContent</code></li></ul><p>By typing any of these you should see the full set of documented variables for those components appear.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://user-images.githubusercontent.com/1770056/104071701-aef45a00-51d7-11eb-8dd4-a15d64c7414e.gif" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://user-images.githubusercontent.com/1770056/104071701-aef45a00-51d7-11eb-8dd4-a15d64c7414e.gif" alt="Untitled Image" height="488" width="1000" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="upcoming-documentation">Upcoming Documentation</h2><p>We are hard at work on a new and improved version of our theme guide, which will include written guides as well as a theme API reference with all documented variables (the same ones with autocomplete and descriptions in the theme editor).</p><p>Additionally we are currently working on variable documentation for the following components:</p><ul><li><code class="code codeInline" spellcheck="false" tabindex="0">global</code></li><li><code class="code codeInline" spellcheck="false" tabindex="0">searchResult</code> </li><li><code class="code codeInline" spellcheck="false" tabindex="0">button</code></li><li><code class="code codeInline" spellcheck="false" tabindex="0">homeWidget</code></li><li><code class="code codeInline" spellcheck="false" tabindex="0">events</code></li></ul><h2 data-id="theming-engine-changes">Theming Engine Changes</h2><p>This release contained some internal refactoring of the styling engine in order to improve stability and reduce chances of future regressions. In order to complete this refactoring the way various CSS class names are generated has changed.</p><p>Some site owners and developers may have notice that various new foundation components, like the Title Bar, Banner, Events module, and more had some seemingly randomized characters at the end of their CSS classes. (For example <code class="code codeInline" spellcheck="false" tabindex="0">.titleBarNav-navigation_f45h</code>). These classes are <strong><em>not stable to apply CSS to, </em></strong>and the recommended way to adjust their appearance is through the variables for their associated components.</p><p>In this release the format of these CSS class names are changing slightly. That same component will now have a CSS class name in a format similar to <code class="code codeInline" spellcheck="false" tabindex="0">.vanilla-579lyi-titleBarNav-navigation</code>.</p><p>This brings a couple of recommendations:</p><ul><li>Any sites that are currently styling on these types of classes should test this release on their staging environment. You may need to update your CSS.</li><li>If possible, try to use the variables for these components (which now have inline documentation in the theme editor).</li><li>If you still must style on the CSS class, be aware that the hash after <code class="code codeInline" spellcheck="false" tabindex="0">vanilla</code> may change in a future release. You should change your CSS selectors to reflect this. For example using <code class="code codeInline" spellcheck="false" tabindex="0">[class*="titleBar-navigation"]</code> instead of of <code class="code codeInline" spellcheck="false" tabindex="0">.vanilla-579lyi-titleBarNav-navigation.</code></li><li>Be aware that features are actively being added to these types of components that can be easily and safely controlled through the documented theme variables. You may need to validate your CSS again in future releases if the structure of the component changes to accommodate new features or bug fixes.</li></ul><h2 data-id="post-statuses-on-search">Post Statuses on Search</h2><p>This release includes an update to our new search page and search API that allows us to expose the post status on search results and on search autocomplete. </p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/23YTDZ1CNQ5U/screen-shot-2021-01-11-at-8-53-56-am.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/23YTDZ1CNQ5U/screen-shot-2021-01-11-at-8-53-56-am.png" alt="Screen Shot 2021-01-11 at 8.53.56 AM.png" height="450" width="1452" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="new-webhook-events">New Webhook Events</h2><p>With this release we have added the follow webhook Events:</p><ul><li>Reactions </li><li>Answer: to keep track of changes to Q&A status changes </li></ul><div class="js-embed embedResponsive" data-embedjson="{"body":"Webhooks are a great way to improve integrations between sites and services. They allow for an automated way to keep separate systems up-to-date about what might be going on. Vanilla's Webhooks addon can allow you to receive automated notifications of key events on a site, like user registrations or new comments. To use…","photoUrl":"https:\/\/us.v-cdn.net\/6030677\/uploads\/947\/TM5DAO1BWY5V.png","url":"https:\/\/success.vanillaforums.com\/kb\/articles\/262-webhooks","embedType":"link","name":"Webhooks - Vanilla Success"}"> <a href="https://success.vanillaforums.com/kb/articles/262-webhooks" rel="nofollow noreferrer ugc"> https://success.vanillaforums.com/kb/articles/262-webhooks </a> </div><h2 data-id="bug-fixes-enhancements">Bug Fixes & Enhancements</h2><ul><li><strong>Keyword Blocker updates </strong>to add support for phrases. You can now add phrases to your list of blocked words. Posts containing this phrase will be flagged and sent to Moderation Queue for review.</li><li>Fixed Instagram Embed failing with Status 500 error - <a href="https://github.com/vanilla/support/issues/3192" rel="nofollow noreferrer ugc">support#3192</a></li><li>Fixed occasional permission errors when editing articles - <a href="https://github.com/vanilla/vanilla-cloud/issues/1630" rel="nofollow noreferrer ugc">vanilla-cloud#1630</a></li><li>Fixed the view all link for Recommended Articles - <a href="https://github.com/vanilla/support/issues/3229" rel="nofollow noreferrer ugc">support#3229</a></li><li>Fixed endless load in message dropdown - <a href="https://github.com/vanilla/support/issues/3341" rel="nofollow noreferrer ugc">support#3341</a></li><li>Fix ability to access subcommunity categories from outside the subcommunity -<a href="https://github.com/vanilla/support/issues/2982" rel="nofollow noreferrer ugc">vanilla/support#2982</a></li><li>Update handleAjaxForm to use simple closure for redirects - <a href="https://github.com/vanilla/support/issues/3392" rel="nofollow noreferrer ugc">vanilla/support#3392</a></li><li>Fix categories recent post updating with troll users - <a href="https://github.com/vanilla/support/issues/3207" rel="nofollow noreferrer ugc">vanilla/support#3207</a></li><li>Fix civiltongue Thai language support - <a href="https://github.com/vanilla/support/issues/3182" rel="nofollow noreferrer ugc">vanilla/support#3182</a></li><li>Fix viewing group bookmarks outside groups - <a href="https://github.com/vanilla/support/issues/3162" rel="nofollow noreferrer ugc">vanilla/support#3162</a></li><li>Fix users unable to view group discussions & comments from profile -<a href="https://github.com/vanilla/support/issues/3271" rel="nofollow noreferrer ugc">vanilla/support#3271</a></li><li>Fix users invitations view - <a href="https://github.com/vanilla/support/issues/3416" rel="nofollow noreferrer ugc">vanilla/support#3416</a></li><li>Fix updating question answered date - <a href="https://github.com/vanilla/support/issues/3449" rel="nofollow noreferrer ugc">vanilla/support#3449</a></li><li>Fix rate limit error when approving user registrations - <a href="https://github.com/vanilla/support/issues/3439" rel="nofollow noreferrer ugc">vanilla/support#3439</a></li><li>Fix dashboard user search - <a href="https://github.com/vanilla/support/issues/3446" rel="nofollow noreferrer ugc">vanilla/support#3446</a></li><li>Fix "Terms of User Manager" missing password field when connecting over SSO - <a href="https://github.com/vanilla/internal/issues/2402" rel="nofollow noreferrer ugc">vanilla/internal#2402</a></li><li>Fix group search auto-complete on nodes - <a href="https://github.com/vanilla/support/issues/3277" rel="nofollow noreferrer ugc">vanilla/support#3277</a></li><li>Fix terms being displayed on log-in error - <a href="https://github.com/vanilla/support/issues/3189" rel="nofollow noreferrer ugc">vanilla/support#3189</a></li><li>Fix rate limit error being returned when "Terms of User Manager" is enabled -<a href="https://github.com/vanilla/support/issues/3383" rel="nofollow noreferrer ugc">vanilla/support#3383</a></li><li>Fix permission check on settings page - <a href="https://github.com/vanilla/support/issues/3401" rel="nofollow noreferrer ugc">vanilla/support#3401</a></li><li>Fix "Syntax Prettifier" config permissions - <a href="https://github.com/vanilla/vanilla-patches/issues/711" rel="nofollow noreferrer ugc">vanilla/vanilla-patches#711</a></li><li>Fix "Syntax Prettifier" endpoint permissions - <a href="https://github.com/vanilla/vanilla-patches/issues/711" rel="nofollow noreferrer ugc">vanilla/vanilla-patches#711</a></li><li>Fix mixed layout announced discussions display - <a href="https://github.com/vanilla/support/issues/3346" rel="nofollow noreferrer ugc">vanilla/support#3346</a></li><li>Fix unanswered questions count - <a href="https://github.com/vanilla/support/issues/3335" rel="nofollow noreferrer ugc">vanilla/support#3335</a></li><li>Fix pockets not displaying for roles of type "guest" - <a href="https://github.com/vanilla/support/issues/3286" rel="nofollow noreferrer ugc">vanilla/support#3286</a></li><li>Fix tags disappearing when a discussion is moved - <a href="https://github.com/vanilla/support/issues/3300" rel="nofollow noreferrer ugc">vanilla/support#3300</a></li><li>Fix category permissions in subcommunity dropdown - <a href="https://github.com/vanilla/support/issues/3283" rel="nofollow noreferrer ugc">vanilla/support#3283</a></li><li>Fix iOSv11 compatibility error - <a href="https://github.com/vanilla/support/issues/3118" rel="nofollow noreferrer ugc">vanilla/support#3118</a></li><li>Fix "Private Discussions" encoding - <a href="https://github.com/vanilla/support/issues/3311" rel="nofollow noreferrer ugc">vanilla/support#3311</a></li><li>Fix "Private Community" blocking sitemaps - <a href="https://github.com/vanilla/support/issues/3259" rel="nofollow noreferrer ugc">vanilla/support#3259</a></li><li>Fix embedding own domain urls - <a href="https://github.com/vanilla/support/issues/3276" rel="nofollow noreferrer ugc">vanilla/support#3276</a></li><li>Fix usercards displaying on badge page - <a href="https://github.com/vanilla/support/issues/3376" rel="nofollow noreferrer ugc">vanilla/support#3376</a></li><li>Fix category follow filtering sub-categories - <a href="https://github.com/vanilla/support/issues/3348" rel="nofollow noreferrer ugc">vanilla/support#3348</a></li><li>Fix discussion read status font-weight - <a href="https://github.com/vanilla/support/issues/3338" rel="nofollow noreferrer ugc">vanilla/support#3338</a></li><li>Fix mod message images width - <a href="https://github.com/vanilla/support/issues/3280" rel="nofollow noreferrer ugc">vanilla/support#3280</a></li><li>Fix search results and profile/comments WYSIWYG encoding - <a href="https://github.com/vanilla/support/issues/3372" rel="nofollow noreferrer ugc">vanilla/support#3372</a> and <a href="https://github.com/vanilla/support/issues/3428" rel="nofollow noreferrer ugc">vanilla/support#3428</a></li><li>Fix inaccurate number of selected comments display - <a href="https://github.com/vanilla/support/issues/3411" rel="nofollow noreferrer ugc">vanilla/support#3411</a></li><li>Fix "unanswered" page being filtered by category follow - <a href="https://github.com/vanilla/support/issues/3435" rel="nofollow noreferrer ugc">vanilla/support#3435</a></li></ul><h2 data-id="backported-fixes">Backported fixes</h2><p>The following fixes have been added to Release 2021.001</p><ul><li>Fix duplicated discussions with Resolved Discussions v2 – <a href="https://github.com/vanilla/support/issues/3528" rel="nofollow noreferrer ugc">support#3528</a></li><li>Add email validation for group invitations by email – <a href="https://github.com/vanilla/support/issues/3288" rel="nofollow noreferrer ugc">support#3288</a></li><li>Allow editing of Idea-Category options – <a href="https://github.com/vanilla/vanilla-cloud/pull/1824" rel="nofollow noreferrer ugc">vanilla-cloud#1824 </a></li><li>Fix errors with embeds & hyperlinks in Rich Editor – <a href="https://github.com/vanilla/support/issues/3554" rel="nofollow noreferrer ugc">support#3554</a> – <a href="https://github.com/vanilla/support/issues/3523" rel="nofollow noreferrer ugc">support#3523</a> – <a href="https://github.com/vanilla/support/issues/3555" rel="nofollow noreferrer ugc">support#3555</a></li><li>Fixed issue where new Advanced Settings option was not appearing in the Theme Editor – <a href="https://github.com/vanilla/support/issues/3532" rel="nofollow noreferrer ugc">support#3532</a></li><li>Fix failures in applying Rank to user – <a href="https://github.com/vanilla/support/issues/3530" rel="nofollow noreferrer ugc">support#3530</a> – <a href="https://github.com/vanilla/support/issues/3580" rel="nofollow noreferrer ugc">support#3580</a></li></ul><p><br></p> </article> </main>