-
Pixel Exit Staff
- Replies: 23
We're excited to announce that our styles are now ready for XenForo 2.3! Sometime tomorrow, you'll receive an email when the update is ready or download. Our goal is to ensure that your upgrade process is as smooth as possible. While most of you will find these updates painless, please take extra caution when upgrading to 2.3. We highly recommend installing the upgrade on a test site before applying it to your production site (2.3 is still in RC as of this post and isn't ready for production).
Let's dive into the key changes and new features:
Old approach:
For 2.2, if you were running a light/dark style, it might look like one of the following setups:
New approach:
Not all styles will have an alternate variation. For these styles, the user will not see the style variation dropdown. The following styles will not have a "light" mode:
We've added a new property "xbStyleVariationHeaderLink" Style variation dropdown in header which adds the style preference in the header next to the alert/search icons.
Each button at the bottom is completely configurable. The bar is intended for logged-in users, so at the moment it does not show to guests. You can arrange the buttons however you'd like. We have an option to disable the primary navigation element if you enable it on the mobile bar (so the Account icon wouldn't display twice.
You can use our Custom Button 1/2/3 to setup custom links. An example link has been provided in those templates.
Let's dive into the key changes and new features:
Style variations (light/dark mode)
XenForo 2.3 introduces "style variations," allowing for a built-in dark mode that adapts to the user's system preference (light/dark). This changes our approach to the style structure for light and dark modes.Old approach:
For 2.2, if you were running a light/dark style, it might look like one of the following setups:
New approach:
- We will no longer ship separate styles for light and dark modes.
- You will now run a single style that can switch between light and dark variations based on the user's preference.
Not all styles will have an alternate variation. For these styles, the user will not see the style variation dropdown. The following styles will not have a "light" mode:
- Omni
- Fusion Gamer
- Evolve
- Blackened Pro
- Apex
We've added a new property "xbStyleVariationHeaderLink" Style variation dropdown in header which adds the style preference in the header next to the alert/search icons.
New mobile bar
All styles will now have access to our new mobile bar feature.Each button at the bottom is completely configurable. The bar is intended for logged-in users, so at the moment it does not show to guests. You can arrange the buttons however you'd like. We have an option to disable the primary navigation element if you enable it on the mobile bar (so the Account icon wouldn't display twice.
You can use our Custom Button 1/2/3 to setup custom links. An example link has been provided in those templates.
Notable changes
- Primary Link Color Property: To improve visibility, we’ve added a primary link color property. For example, Bolt’s links are now more distinguishable from regular text.
Bolt on 2.2:
Bolt on 2.3
More examples of bad link coloring for Bolt 2.2:
Bolt on 2.3:
As of right now, the link colors are as follows for most styles:- Forum Node titles + Thread List titles = Primary link color
- There's a new property called Primary link classes (xbPrimaryLinkClasses) under Style properties -> Page setup. You can add additional classes here so they inherit the primary link color + the primary link color hover.
- Message links = User-generated content link color
- All other links = Link color
- Forum Node titles + Thread List titles = Primary link color
- REM Support- Going forward, our new styles will all use REM font sizing. With this update, we chose not to update existing styles to REM from px font sizing because it could simply change too much for some communities without a lot of tweaks from you. Further documentation will be created to update your existing styles although it's an easy task to do so now. REM font sizing makes it easier to achieve various things such as
- Global font changes are various screen widths
- Easily enable a custom user field to have your users make the font sizes smaller/larger globally
Some Key Notes
- Old FA codes such as:
Code:
.m-faBase(); .m-faContent("\f27a");
Code:.m-faContent(@fa-var-arrow-right);
- The old .style-dark class will no longer work. Instead, the CSS should be: [data-color-scheme="dark"] &
- Deleted "sources" asset location - In the end you really only need stylefolder as it can link to anywhere in the style folder
- Cancel buttons no longer use a primary button color but instead the "button link" which much more subtle.
- Deleted Backstretch (outdated library)
- Style specific changes
Style specific changes
- Core
- paletteAccent1 changed to a grey tone, orange is now just pulled from paletteAccent2
- Apex
- We've completed a color overhaul for Apex with the 2.3. It was originally setup incorrectly, defined as "light style" according to XenForo color palette, this is now adjusted. We've taken the time to adjust the colors to follow the general standard practices of our style framework.
- Switched button colors for UX purposes (Cancel is no longer the focus versus Save as an example)
- Top bar disabled by default
- Bolt
- Removed "boltNodeIconGradient" with XenForo's new way of Font Awesome icon processing, I don't see a way to keep this
- Header/footer background images removed
- Core
Attachments
Last edited: