[4.0] Fix Untranslated tip

[infograf768]

Summary of Changes

As title says. The tip displays in the articles Manager when an article is Unpublished.
It concerns the COM_CONTENT_CHANGE_STAGE lang string

Testing Instructions

Create an article as Unpublished.
make sure publish up and down are empty
Hover the Status icon.

Before patch

After patch

About this patch

It is the simplest solution but we have another solution by passing through Text the string in both
articles/default.php and featured/default.php

													->addState(ContentComponent::CONDITION_PUBLISHED, '', 'publish', 'COM_CONTENT_CHANGE_STAGE', ['tip_title' => 'JPUBLISHED'])
													->addState(ContentComponent::CONDITION_UNPUBLISHED, '', 'unpublish', 'COM_CONTENT_CHANGE_STAGE', ['tip_title' => 'JUNPUBLISHED'])
													->addState(ContentComponent::CONDITION_ARCHIVED, '', 'archive', 'COM_CONTENT_CHANGE_STAGE', ['tip_title' => 'JARCHIVED'])
													->addState(ContentComponent::CONDITION_TRASHED, '', 'trash', 'COM_CONTENT_CHANGE_STAGE', ['tip_title' => 'JTRASHED'])
													

I can change the PR if judged necessary.

[SharkyKZ]

another solution by passing through Text the string in both
articles/default.php and featured/default.php

That's better. But I wonder whether passed strings should be translated or not. Here they're not translated:

joomla-cms/libraries/src/Button/PublishedButton.php

Lines 32 to 35 in 551e356

	$this->addState(1, 'unpublish', 'publish', 'JLIB_HTML_UNPUBLISH_ITEM', ['tip_title' => 'JPUBLISHED']);
	$this->addState(0, 'publish', 'unpublish', 'JLIB_HTML_PUBLISH_ITEM', ['tip_title' => 'JUNPUBLISHED']);
	$this->addState(2, 'unpublish', 'archive', 'JLIB_HTML_UNPUBLISH_ITEM', ['tip_title' => 'JARCHIVED']);
	$this->addState(-2, 'publish', 'trash', 'JLIB_HTML_PUBLISH_ITEM', ['tip_title' => 'JTRASHED']);

So maybe translation should be performed in Joomla\CMS\Button\PublishedButton::render() instead.

[infograf768]

Afaik that part of PublishButton is not used for articles but may be for other managers and it is translated somewhere else. The articles manager loads a new PublishButton with specific states because of workflow. Then it is displayed by the transition-button where the textip (data content) depends of the state of the article obtained by Publish button when the article is published.
When it is unpublished, we need to use this pr or add Text:: in the default.php.
So we have to decide which solution to use OR refactor the whole stuff.

[SharkyKZ]

It's not translated as far as I can tell. After removing custom com_content states, I get JLIB_HTML_PUBLISH_ITEM in the tooltip which is what other components will get with default button.

[infograf768]

It's not translated as far as I can tell.

Indeed. In fact it looks like it is never used in core... What is used elsewhere is JGrid.
Only occurence of new PublishedButton are in both articles/default.php and featured/default.php

Looks like it "could" be used by 3rd party in the future.

Therefore I think it is safer to add the Text:: both in the default.php files and PublishedButton itself. On it.

[infograf768]

Please test again.

[SharkyKZ]

Grrrr... Now it looks weird because title has to be translated but tip_title doesn't 🤷‍♂.

[infograf768]

@SharkyKZ
I found where the original issue comes from.
It was my patch #27078 ;)
I had modified the transition-button there to prevent double translation when we had "Start Date etc.)
Debug Lang was marking it this way:

I patched this way

- data-content="<?php echo HTMLHelper::_('tooltipText', Text::_($title), '', 0); ?>"
+ data-content="<?php echo HTMLHelper::_('tooltipText', $title, '', 0); ?>"

Therefore the $title is untranslated when the article is unpublished.

We have to take a decision. Do we reinstate the Text there (and get a wrong debug lang) or modify as done in this PR?

[SharkyKZ]

I just don't like that one string we pass has to be translated but the other doesn't. I see two options here:

1. Remove translation from button layout and pass only translated strings to PublishedButton::addState().

2. Remove translation from button layout and perform all translations in PublishedButton::render().

[infograf768]

I'm afraid I can't do what you suggest.

[SharkyKZ]

You mean you don't know how to do it or you don't agree with proposed solutions?

[infograf768]

Don’t know how. 😄

[SharkyKZ]

Remove Text::_() calls from layouts/joomla/button/transition-button.php and add them to tip_title constants like you already did for title, e.g. here

joomla-cms/administrator/components/com_content/tmpl/articles/default.php

Line 252 in b264d75

->addState(ContentComponent::CONDITION_PUBLISHED, '', 'publish', Text::_('COM_CONTENT_CHANGE_STAGE'), ['tip_title' => 'JPUBLISHED'])

This should also fix remaining double translations which aren't visible in core.

[infograf768]

@SharkyKZ
Done and it does work indeed (changes were also needed in PublishedButton).

BUT, remains a case.
See transition-button $only_icon = empty($options['transitions']);
https://github.com/joomla/joomla-cms/blob/4.0-dev/layouts/joomla/button/transition-button.php#L31-L40

I did not touch for the moment at the Text::_() stuff when $only_icon is set as I don't know how to test that part. The logic is to also modify there but not sure at all.

If you don't know, maybe @bembelimen knows the uses of that part.

[SharkyKZ]

Yes, remove those Text::_() calls too. It works the same way. For testing purposes you can just set $only_icon to true.

[infograf768]

Done. Can be now tested. I fail to understand the use of $only_icon. Why would anyone lose the ability to modify via the icon is a mystery to me...

[SharkyKZ]

Remove use Joomla\CMS\Language\Text; from button layout please.

[infograf768]

Done.

[infograf768]

needs more work for featured.
On it

[SharkyKZ]

Remove Text::_() here too please:

joomla-cms/layouts/joomla/button/action-button.php

Line 40 in 0f6751f

<span class="sr-only"><?php echo Text::_($title); ?></span>

And with that use Joomla\CMS\Language\Text; too.

[infograf768]

LOL
Hope it was the last one...

[SharkyKZ]

I have tested this item ✅ successfully on 0318b14

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/27174.}

[Quy]

I have tested this item ✅ successfully on 0318b14

RTC

---

_{This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/27174.}

[wilsonge]

This looks better to me translating the tips this way (sorry for not looking before JM!). Thanks!

[infograf768]

Thanks to all who helped on this. Was a long road... ;)
I still have no idea why we offer the variable $only_icon though except for overrides of the admin templates.