XF 2.3 Miscellaneous changes for XenForo 2.3

Due to time constraints and family matters, this is a slightly different HYS to what was planned, but it is still a bumper feast of new features coming in XenForo 2.3. This week we will be mostly focusing on a bunch of smaller new changes and improvements we're no less excited to show you in the near future.

This is a somewhat lengthy post so we will say goodbye here and we will see you for more 2.3 goodies next week.

Sign in with Apple​

To join our existing suite of connected account providers, in XenForo 2.3 we are adding support for Sign in with Apple. The set up for this one will be a little more onerous, requiring an Apple developer account and the creation of a certificate file that will need to be uploaded through our UI:

hys_6_apple_1.png


Before release, we will be documenting the full setup process through the XenForo manual. There is also an additional step required for users who sign up with Apple's "Hide my e-mail" feature.

Once enabled, users will be able to sign in, or sign up with the Apple button in the relevant places.

hys_6_apple_continue.png


Search users for connected accounts​

If you've ever wondered which of your users have which connected accounts connected, you can now pull that list directly from the "Search users" page in your admin control panel.

hys_6_user_search.png


Simply select the specific connected account(s) you want to search for, and the list of users who have those accounts connected will be displayed.

IndexNow support​

In XenForo 2.3 you can now enable support for IndexNow. This is a recent initiative by Bing, Yandex and others, which allows you to directly notify them whenever content is created, updated, or deleted on your forum. Whenever one of these events happens, a job is enqueued to submit the URL to IndexNow. This avoids the need for generating huge sitemap files which may or may not be read by search engines.

Due to limited support by search engines, including Google, the sitemap generation remains in place and remains unchanged, but IndexNow is available for those search engines which support it either now or in the future.

Generically queued and retryable jobs​

Starting with XenForo 2.3, the existing job system has been enhanced with additional tracking which allows it to be used as a generic queueing system. In XenForo 2.2, mails are added to a special queue table before being processed. This functionality remains largely unchanged, but instead of queueing mails to be sent in their own table, they are now queued directly into the xf_job table.

It's not just mails which are queued in this way. The sending of push notifications and webhooks are also now queued into the job system, so there is little to no noticeable delay when submitting content which might generate one or more of these to be sent.

In addition to queueing these items in this way, developers can also opt in to having their jobs be retryable in the event of failure. This maintains the current behaviour of the existing mail queue and also allows webhooks to be retried in the event of failure.

The cool off between retrying can be configured directly in the Job class or use sensible defaults so that the delay between retries is lengthened based on the number of previous attempts.

After a certain number of failed attempts, the jobs can be marked as failed and they are stored in a new xf_failed_job table.

Bundled support for remote object storage​

Thanks to some changes in the AWS SDK for PHP we are now able to ship, alongside XenForo, the parts of the library which are responsible for communicating with Amazon S3 and compatible object storage services.

The setup instructions provided by the below resource are still required:

But starting with XenForo 2.3 you will no longer need to install an "add-on" in order to configure it. Calling it an "add-on" is a little bit of a misnomer as all it really does is include the (previously) humongous AWS SDK. Now we can include just the Amazon S3 SDK parts, there are fewer steps required to offloading your storage to a remote service, like Amazon S3, Cloudflare R2 and many others.

Full InnoDB support with improved MySQL search​

In days gone by, there were good reasons for our continued use of MyISAM and MEMORY tables in MySQL. Though as the years have progressed, the need for these storage engines in databases have long been negated by better hardware performance and improvements in InnoDB.

Starting with XenForo 2.3 we are automatically converting most of the remaining tables to use InnoDB and for new installs we are making all tables use InnoDB by default.

The only table that requires manually converting is the xf_search_index table. For existing installations, due to differences in the full-text search implementation, you will need to run a CLI command named xf:convert-search-innodb, which will empty, convert and optionally rebuild the search index for you.

Full text search using InnoDB should be an improvement right out of the gate as it offers a lower default minimum word length and a much smaller set of stop-words, along with an improved scoring algorithm. We now even support relevancy search order out of the box, something that was previously a XenForo Enhanced Search exclusive feature, though this will be subject to real world testing before we can comment on whether it is useful.

Due to these changes we are going to be requiring a minimum of MySQL 5.7 or MariaDB 10.2 starting with XenForo 2.3.

Native 'sticky' and date/time inputs​

Due to ancient browser quirks which should no longer be relevant and improved HTML standards, we are now handling sticky elements and date inputs natively without the use of third party libraries.

In terms of 'sticky' support, this affects mostly the admin control panel navigation and the sticky header on the public side in some legacy cases. For the most part, you shouldn't see any difference and the experience, particularly for the admin control panel navigation, should be a lot less janky in some of the cases.

Date inputs within XenForo have now been replaced with native date inputs, rather than using a third party library. Each browser/OS will render the date picker slightly differently, as seen below (Chrome, Firefox, macOS Safari and iOS pictured):

hys_6_date_chrome.png
hys_6_date_firefox.png
hys_6_date_safari.png
hys_6_date_apple.png

But all of them are at least much more functional than they used to be and will be familiar to people who have used the date inputs before.

In addition to supporting date inputs with the existing <xf:dateinput> tag, we also support date and time inputs with the <xf:datetime> tag and time inputs using the <xf:timeinput> tag, which correspond to the HTML standard <input type="date">, <input type="datetime-local"> and <input type="time"> tags respectively.

Auto refresh "board inactive" page​

For those times when you need to turn your forum off, you will have used the "board is active" toggle to do so. This page will now automatically refresh every 60 seconds so when the forum is back up, people will be back using your site sooner without needing to hit refresh.

Anchor links for headings​

Every time a heading is used within content, it now has an automatic anchor link generated which can be accessed on hover via the link icon that appears next to the heading:

hys_6_heading.png


This will allow you to link directly to headings within your content.

Email notifications for moderators​

Sometimes it can be tricky keeping up to date with the various goings on with a busy forum, or if you're a small team, sometimes it can be difficult to respond to various moderator tasks.

To make that easier in XenForo 2.3, moderators can now opt-in to email alerts for new reported content or new content awaiting approval,

hys_6_moderator_emails.png


With these preferences enabled (on a per-moderator basis under account preferences), whenever any of those actions require attention, an email will be sent to those moderators.

User ID matches expression​

New for 2.3 is an addition to the user criteria selector that allows CSS-style :nth-child selectors against user IDs. While this might initially sound like gobbledygook, there is a powerful application for this tool.

1698099926187.png


Let's imagine that you have a user group promotion that grants access to a 'Testing group' user group, and applies to all users with a 2n value for 'User ID matches expression. This promotion will apply to any user whose user ID is even. You can then enable specific functionality for users in the 'Testing group', and use various tools to measure their engagement with those tools, compared to those not in that group who do not have access to the changed functionality. In short, you have a quick and easy way to do A/B testing on your entire user base.

Of course you don't have to limit your testing to one group. You could set up 3n, 3n+1 and 3n+2 criteria on three separate promotions to divide your user base into three groups, or set up segregation however you like.
 
Last edited:
Lots of little new features and improveent.
Most of which are not much interest to me
But I like the refresh of the forum when board is back active
 

Email notifications for moderators​


I don't like it. That just distributes sensitive information, if a report has such, into a wider area that can't be controlled by the site admins, such as non encrypted mail boxes like hotmail.

Why not just add a field called moderator notification webhook, where someone can add a webhook link for a discord or slack channel.

Unless Im misunderstanding and report message contents will be hidden in emails.
 
Last edited:
That just distributes sensitive information, if a report has such, into a wider area that can't be controlled by the site admins, such as non encrypted mail boxes like hotmail.
Fair point.

I guess you don't have to use this feature and even if you want to use it you could just modify the email template so the subject of the emails would just be "New reported content at website" / "New content awaiting approval at website" with the body just being an ID-based link to the report or content waiting approval.

This wouldn't disclose much (sensitive information).

Why not just add a field called moderator notification webhook, where someone can add a webhook link for a discord or slack channel.
Persoally, I'd consider email (with mandatory TLS of course) lass problematic (from a privacy POV) than using public cloud services like Slack or Discord.

If you take privacy really serious the best option IMHO would be smth. that is (at least theoretically) end-to-end encrypted, for example S/MIME.

XenForo doesn't support this out-of-the-box, but Swiftmailer (Symfony Mailler in XenForo 2.3) does - so it shouldn't be too difficult to add support for this via an Add-on.

Unless Im misunderstanding and report message contents will be hidden in emails.
I'd expect that the message content wil be included by default (as I'd image most customers would want to have it that way).
But as said before, it should be easy to modify the template(s) in this case.
 

Anchor links for headings​

Every time a heading is used within content, it now has an automatic anchor link generated which can be accessed on hover via the link icon that appears next to the heading:

This will allow you to link directly to headings within your content.
Would existing links change if headings are added to existing content?

Eg. I create a post with 2 headings and put the link for the second heading in my signature.
Afterwards I add a 3rd heading between the first and second heading.

Would the link to the third (initially second) heading still work?
 
It's nothing to do with Apple or a cost associated with an app.

It's simply a video which is shown to members with Apple devices to show them how to add the icon to the home page.

You don't need to set anything up, it's automatic.
 
Back
Top Bottom