Hello, everyone!
As you may have noticed, we've made some changes to our flagship Persona theme. On mobile, the slideout menu is now on the left to match with the convention on native phone UIs. We've also moved chats into a separate slideout menu on the right side, so it is now much easier to see how many unread messages you have.
To accomplish these changes, we moved from the existing slideout menu library, Slideout.js, to a brand new, custom built slideout menu library, which we plan on releasing as a separate module soon.
This was a large change, and we want to ensure the functionality and behavior of the menus are flawless. So, we're asking for your feedback. Please reply with any bugs or concerns, thanks!
Child Themes
This Persona change is a breaking change for child themes. To adapt your child theme to the new Persona, you will need to do the following after this new version of Persona is released:
- if overriding the
partials/menu
or header
templates, update them to include the changes
- add the
slit.js
file to the modules
property of theme.json
, and remove slideout.js
from the scripts
- if using your own client-side JS library instead of the one shipped with Persona, you'll need to implement the same changes made to
persona.js
If you wish to keep the old version of the menus, you will need to do this instead:
- copy the
partials/menu
and header
templates from Persona so your theme overrides them
- copy
persona.js
and slideout.js
to your theme and include them in your scripts
if you aren't using custom versions already
Known issues
It appears that the Recent Cards plugin incorrectly set the marker telling the slideout menus to ignore touch moves on the cards. This has been fixed and will be released in a new version soon.