Language Change PR-6.0-dev Pending

User tests: Successful: Unsuccessful:

avatar obuisard
obuisard
23 Jun 2025

Summary of Changes

Empty states often go unnoticed once a Joomla site is fully built, but when introducing new functionality, they offer a prime opportunity to guide users. Embedding a guided tour directly within these blank areas can greatly enhance user onboarding. There’s no more relevant place to learn about the functionality than in that page.

Testing Instructions

Check that tours are available and run from the following pages (no items must be present, you will need to trash then delete items on a test site if necessary to see the empty state):

administrator/index.php?option=com_content&view=articles
administrator/index.php?option=com_categories&view=categories&extension=com_content
administrator/index.php?option=com_banners&view=banners
administrator/index.php?option=com_contact&view=contacts
administrator/index.php?option=com_newsfeeds&view=newsfeeds
administrator/index.php?option=com_finder&view=filters
administrator/index.php?option=com_tags&view=tags
administrator/index.php?option=com_guidedtours&view=tours
administrator/index.php?option=com_guidedtours&view=steps&tour_id=XXX
where XXX is the id of a newly created tour.

Actual result BEFORE applying this Pull Request

image

Expected result AFTER applying this Pull Request

image

Link to documentations

Please select:

  • Documentation link for docs.joomla.org:

  • No documentation changes for docs.joomla.org needed

  • [?] Pull Request link for manual.joomla.org:

  • No documentation changes for manual.joomla.org needed

avatar obuisard obuisard - open - 23 Jun 2025
avatar obuisard obuisard - change - 23 Jun 2025
Status New Pending
avatar joomla-cms-bot joomla-cms-bot - change - 23 Jun 2025
Category Administration com_banners com_categories com_contact com_content com_finder com_newsfeeds com_tags Language & Strings Layout
avatar obuisard obuisard - change - 23 Jun 2025
The description was changed
avatar obuisard obuisard - edited - 23 Jun 2025
avatar obuisard obuisard - change - 26 Jun 2025
Labels Added: Language Change PR-6.0-dev
avatar brianteeman brianteeman - test_item - 26 Jun 2025 - Tested successfully
avatar brianteeman
brianteeman - comment - 26 Jun 2025

I have tested this item ✅ successfully on b7a2931


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/45647.

avatar brianteeman brianteeman - alter_testresult - 26 Jun 2025 - brianteeman: Not tested
avatar brianteeman
brianteeman - comment - 26 Jun 2025

I would have made a successful test but the tour for categories is not correct. It assumes that you are creating a tour for categories for com_content but it is displayed for all category instances. So if you have no banner categories and run through the tour you end up creating a content category and not a banner category.

Either remove the category tour from empty state (it will rarely be displayed anyway)
or
The category tour will need to be context aware to ensure that after the tour a category is created for the correct component

I would go for the first option


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/45647.

avatar obuisard
obuisard - comment - 26 Jun 2025

Either remove the category tour from empty state (it will rarely be displayed anyway) or The category tour will need to be context aware to ensure that after the tour a category is created for the correct component

I would go for the first option

I agree, I have removed the tour link for categories.

avatar joomla-cms-bot joomla-cms-bot - change - 26 Jun 2025
Category Administration com_banners com_categories com_contact com_content com_finder com_newsfeeds com_tags Language & Strings Layout Administration com_banners com_contact com_content com_finder com_newsfeeds com_tags Language & Strings Layout
avatar brianteeman
brianteeman - comment - 26 Jun 2025

you're going to need to remove the emptystate on guided tours and steps as well

if there are no tours or steps then the tour you link to in the emptystate cant run can it ;)

avatar obuisard
obuisard - comment - 29 Jun 2025

you're going to need to remove the emptystate on guided tours and steps as well

if there are no tours or steps then the tour you link to in the emptystate cant run can it ;)

Hmmm... where was my brain? Yes, if there are no tours, there is no tour to run to learn about tours...
However, I need to leave the empty state changes for the 'steps' tour as an empty state is visible every time a tour is created.

Add a Comment

Login with GitHub to post a comment