XenForo 2.3 Released Full 2.3.3

XenForo 2.3.3 Released​

XenForo 2.3.3 is now available for all licensed customers to download. We strongly recommend that all customers running previous versions of XenForo 2.3 upgrade to this release to benefit from increased stability.

Directly from your admin control panel

If you are a XenForo Cloud customer, your upgrade will be scheduled automatically.

Some of the changes in XF 2.3.3 include:

• Fix select-to-quote handler error on soft-deleted threads
• Ignore port if Redis host appears to be a file path
• Fix a few cases where hashes were concatenated instead of passed to router
• Fix flickering issue with JS icon renderer
• Fix expandable content transition class callback
• Use correct finder when looking up Stripe subscriber IDs
• Do not attempt to set RSS feed language if no language code is set
• Check if job table exists before attempting to sync structure
• Fix issues serializing nestable elements which contain unrelated lists
• Adjust some automatic alert read-marking behaviors
• Adjust offset of focus-visible tab outline
• Re-enable caching for tag edit overlay
• Fix error handling for fetching/creating PayPal products and plans
• Fix determining locale from language code for string manipulation
• Ensure points phrase is used in trending weights.
• Optimize string transliteration performance
• Override some missing phrases for token inputs.
• Reduce trending content widget queries
• Fix embedding Imgur galleries and applying JS states
• Romanize heading anchors
• Do not force romanization for category anchors
• Fix merging reactions with multiple source reactions from deleted users
• Do not cache report overlays
• Fix Tagify filtering out non-exact matches unexpectedly
• Set 1:1 aspect-ratio on connected account provider icons
• Use the editorButtonSelectedBg property for active editor button backgrounds
• Fix DM icon clipping on desktop Safari
• Fix phrase method casing in icon option handler
• Perform client-size image optimization even when no maximum image width/height is set
• Fix checking if Rocket Loader is disabled in the middle of an upgrade
• Throw an error when attempting to recursively load config file
• Fix string style property variations support for properties without assets enabled
• Prevent double logging of moderator changes for threads when editing first post
• Adjust width of inline time inputs
• Check private use TLDs when determining if a host is local
• Fix some issues with appending filter rows
• Use XF.setupHtmlInsert for filter AJAX responses
• Allow passing HTMLElement objects to alerts
• Fix support for alternative icon variants in custom BB codes
• Fix fetching default avatar when templater style is not set
• Address some phrases which reference conversations
• Handle unexpected values in cookie consent cookie

The following public templates have had changes:

• PAGE_CONTAINER
• account_banner
• app_nav.less
• conversation_message_macros
• core_block.less
• core_button.less
• core_input.less
• core_tab.less
• editor_override.less
• helper_js_global
• member_view
• passkeys_macros
• post_macros
• profile_post_macros
• tag_macros
• token_input

Where necessary, the merge system within the "outdated templates" page should be used to integrate these changes.

As always, new releases of XenForo are free to download for all customers with active licenses. You may now upgrade from your admin control panel or grab the new version from the customer area.

Please note that XenForo 2.3 has higher system requirements than earlier versions.

The following are minimum requirements:

• PHP 7.2 or newer (PHP 8.3 recommended)
• MySQL 5.7 and newer (Also compatible with MariaDB/Percona etc.)
• All of the official add-ons require XenForo 2.3.
• Enhanced Search requires at least Elasticsearch 7.2.

Full details of how to install and upgrade XenForo can be found in the XenForo 2 Manual. We strongly recommend upgrading directly from within your control panel.

XenForo 2.3.2 Released​

XenForo 2.3.2 is now available for all licensed customers to download. We strongly recommend that all customers running previous versions of XenForo 2.3 upgrade to this release to benefit from increased stability.

Directly from your admin control panel

If you are a XenForo Cloud customer, your upgrade will be scheduled automatically.

Some of the changes in XF 2.3.2 include:

• Make PCRE character class check more robust.
• Do not attempt to redefine UTF-8 string shim functions if they already exist
• Rename search forum node type handler as expected
• Fix utf8_isASCII return type
• Fix an issue where the batch size for search rebuilds could grow unbounded
• Strip BBCode from trending content article displays
• Fix a regression with PWA orientation/screen rotation
• Set recommended PHP version dynamically
• Fix profile post position tracking
• Use absolute URLs in approval item emails
• Fix behavior of API keys with all scopes allowed
• Fix thread context support for featured and trending widgets
• Apply inline style to document.head correctly
• Fix type error for file clean counts.
• Attempt to have Cloudflare Rocket Loader automatically ignore scripts
• Don't try to ping IndexNow if no API key is set
• Gate search engine indexing settings for threads behind their own permission
• Fix error on shared IPs list when matching user has been deleted
• Allow the variation menu to open above fixed notices
• Fix saving permissions from the edit user page
• Fix passing \DateTime objects into \XF\Language::getDateTimeParts
• Use XF custom events for overlay and transition events
• Hydrate user relations when setting up base user
• Redirect to the first active option group when viewing an option
• Fix behavior of search short-name conversion
• Handle older SMTP option values more gracefully
• Fix responsive sidebar margins
• If a user can see the thread created by a report, respect their auto watch preference
• Mark threads as nofollow if they are non-indexable
• Support WebP images when uploading images for featured content
• Address several issues with XF.ajax
• Address even more one-click upgrade issues when caching is enabled
• Fix attachment list filter bar dates being displayed in wrong timezone
• Fix using hotkeys to submit a message in the plain text editor
• Fix event handling on auto-complete autosubmission
• Fix importing webp smilies
• Fix implicit join behavior of finder order clauses
• Fix addon_get_install_data code event description
• Only process the color scheme mixin when variations are enabled
• Position BBCode quote expansion link at bottom of quote
• Fix some issues when toggling variations when an active variation is selected
• Pass handler in params when rendering thread edit extra data templates
• Include type data definitions when rendering thread edit extra data templates

The following public templates have had changes:

• PAGE_CONTAINER
• app_body.less
• bb_code.less
• embed_view
• featured_content_edit
• helper_js_global
• helper_thread_options
• page_view
• payment_initiate_twocheckout
• profile_post_macros
• service_worker_offline
• setup.less
• style_variation_macros
• thread_list_macros
• trending_content_item_thread
• two_step_totp

Where necessary, the merge system within the "outdated templates" page should be used to integrate these changes.

As always, new releases of XenForo are free to download for all customers with active licenses. You may now upgrade from your admin control panel or grab the new version from the customer area.

Please note that XenForo 2.3 has higher system requirements than earlier versions.

The following are minimum requirements:

• PHP 7.2 or newer (PHP 8.3 recommended)
• MySQL 5.7 and newer (Also compatible with MariaDB/Percona etc.)
• All of the official add-ons require XenForo 2.3.
• Enhanced Search requires at least Elasticsearch 7.2.

It's time to party like it's 2022 2023 2024! Today we are very pleased (and relieved) to announce the stable release of XenForo 2.3.0 and our official add-ons. It has been a long time coming so we thank you for your patience and support.

There are a myriad of new features and improvements. Here's a brief overview of our favourites:

• Style variants with Dark mode
• Improved performance
• Featured content
• Image optimization
• Automation with webhooks
• SSO with OAuth2
• Passwordless logins with passkeys
• Trending content

This is not an exhaustive list of what's new in 2.3, and you can read more about the above and other new changes/improvements features in the Have you seen...? forum.

As always, new releases of XenForo are free to download for all customers with active licenses, who may now grab the new version from the customer area or upgrade from your Admin control panel (Tools > Check for upgrades...).


Shortly after the release of XenForo 2.3.0, Cloud customers will receive an email notifying them that their upgrade has been scheduled automatically.

Please pay close attention to the scheduled date / time of the upgrade. As a XenForo Cloud customer you are able to defer the automatic upgrade for as far as six months from the date of release. While the sheer majority of customers will be fine upgrading much sooner, we do recommend taking additional time before upgrading to verify that add-ons on which you depend on are updated and style designers have ample time to prepare 2.3.0 compatible versions of styles before upgrading.

Prior to upgrading, ensure you have updated add-ons and styles downloaded and be sure to follow the specific developer/designer's instructions and guidance when upgrading those.

It may also be worth scheduling your upgrade at times where we have more staff available. While XenForo staff are generally available outside of these hours, responses are much quicker during the hours of Monday - Friday 9am to 5pm UK time (currently BST / UTC+1).

Note that add-ons and custom styles may be broken after upgrading to 2.3. You must test your add-ons thoroughly or look for updates. Be especially careful with add-ons that cover similar features to ones that are added to 2.3; these may conflict with the core XenForo data. If data conflicts are found, they will need to be resolved in a new add-on release or by removing the add-on before upgrading to 2.3.

Alongside the release of XenForo 2.3.0, we are also releasing updated versions of each of our official add-ons:

• XenForo Media Gallery 2.3.0
• XenForo Resource Manager 2.3.0
• XenForo Enhanced Search 2.3.0

Each of these has been updated to integrate with the new features in XenForo 2.3 and add features of their own, including:

Improved media gallery performance

Split-score review graph

Search suggestions

Customers with active licenses for these add-ons may download the new versions from their customer area.

The following are minimum requirements:

• PHP 7.2 or newer
• MySQL 5.7 and newer
• All of the add-ons listed here require XenForo 2.3.
• Enhanced Search requires at least Elasticsearch 7.2

Note: Some requirements here have changed. Notably, PHP 7.2 is now required, and MySQL 5.7 (or equivalent) is required. That being said, we highly recommend upgrading to PHP 8.3 or MySQL 8.0 at the earliest opportunity.

Full details for how to install and upgrade XenForo can be found in the XenForo manual. One-click upgrades from XF 2.2 are possible. Once the XF 2.3 upgrade has been complete, the official add-ons should be upgraded as well, otherwise you may run into incompatibilities.

Today we are releasing XenForo 2.3.0 Release Candidate 5. While the majority of this release is focusing on bug fixes and stability, there are a few noteworthy changes.

Automatic legacy file clean up​

XenForo installations after upgrading to XenForo 2.3 will have a number of files sitting in the file system which are no longer used. Any XenForo installation that has been around for a while, will to a lesser extent, have a similar issue. These files on their own shouldn't present any issue, but at the same time, keeping them around doesn't make much sense either.

There are three approaches to cleaning up legacy files automatically.

To address a backwards compatibility issue with some add-ons, we are today releasing XenForo 2.3.0 Release Candidate 4. If you are running Release Candidate 3 already we encourage you to upgrade as soon as possible. If you were previously affected by issues with certain add-ons or experience other issues, please let us know via a bug report in the first instance.

This release also fixes the issue with admin search returning an error.

This week in addition to a bunch of bug fixes, we've also been doing a spot of housekeeping in our code. The following is quite technically heavy so if you're a non-developer, shield your eyes and read the less boring bits.

Much wider usage for class strings​

As a reminder, XenForo 2.3 brings with it support for using native PHP class strings. For example, originally we used "class short names" to point to certain classes. While these were easy to write, it makes refactoring classes difficult, and you need these PHP doc comments to hint to code editors what object is ultimately returned in the code:

PHP:
<span>/** @var \XF\Entity\User $user **/</span><br><span>$user</span> <span>=</span> \<span>XF</span><span>:</span><span>:</span><span>em</span><span>(</span><span>)</span><span>-</span><span>&gt;</span><span>create</span><span>(</span><span>'XF:User'</span><span>)</span><span>;</span>

Our preference going forwards is using class strings:

PHP:
<span>$user</span> <span>=</span> \<span>XF</span><span>:</span><span>:</span><span>em</span><span>(</span><span>)</span><span>-</span><span>&gt;</span><span>create</span><span>(</span>\<span>XF<span>\</span>Entity<span>\</span>User</span><span>:</span><span>:</span><span>class</span><span>)</span><span>;</span>

Because PHP natively understands these special strings, the issues with type hinting are no more, and doing things like renames of classes or moving classes becomes a much more trivial exercise.

Throughout the core XF code now, starting with RC3, we have replaced the majority of these legacy class short names with native class strings.

XenForo & Add-ons 2.3.0 Release Candidate 1 Released​

It's finally here, the first of a series of release candidates for the XenForo 2.3.0 stable release. We still have a bit more work to do and other changes and improvements in the pipeline but at this point the most serious bugs have been tackled and we don't expect many more releases before we can declare it is ready for a stable release.

We strongly recommend anyone testing 2.3 during this pre-release period upgrade as each pre-release version is released.

More specific details regarding bugs fixed in this release can be found in the resolved bugs forum.

This is pre-release software. It is not officially supported.
We do not recommend running it in production.

Please remember that this is pre-release software. It contains known bugs and incomplete functionality. We do not recommend running pre-release software in a production environment, and support is limited at this time to questions here on the community forums.

Add-ons and custom styles may be broken after upgrading to 2.3. You must test your add-ons thoroughly or look for updates. Be especially careful with add-ons that cover similar features to ones that are added to 2.3; these may conflict with the core XenForo data. If data conflicts are found, they will need to be resolved in a new add-on release or by removing the add-on before upgrading to 2.3.

If you choose to run pre-release software, it is your responsibility to ensure that you make a backup of your data. We recommend you do this before attempting an upgrade. If in doubt, always do a test upgrade on a copy of your production data.

All customers with active licenses may now download the new version from the customer area.

Download XenForo 2.3.0 Release Candidate 1​

From the licensed customer area​

Alongside the release of XenForo 2.3.0 Release Candidate 1, we are also releasing updated versions of each of our official add-ons:

• XenForo Media Gallery 2.3.0 Release Candidate 1 (Includes Security Fix)
• XenForo Resource Manager 2.3.0 Release Candidate 1
• XenForo Enhanced Search 2.3.0 Release Candidate 1

Customers with active licenses for these add-ons may download the new versions from their customer area.

Download official add-ons​

From the licensed customer area​

Requirements​

The following are minimum requirements:

• PHP 7.2 or newer
• MySQL 5.7 and newer
• All of the add-ons listed here require XenForo 2.3.
• Enhanced Search requires at least Elasticsearch 7.2