User tests: Successful: Unsuccessful:
The text used in the update email notification message is not ideal. The tone of the message is not particularly friendly and there are too many unnecessary disclaimers and explanations. All of this takes focus away from the purpose of the notification, the focus needs to be on encouraging users to update and helping them update - as helping users keep their install updated is the intent of the feature.
A piece of user feedback we received says it all:
“The language used in the email notice is atrocious. It comes off as angry and is far too much text for a simple notice that there's an update available.”
A more detailed analysis and recommendations can be found in this document:
https://docs.google.com/document/d/18rLT1UruY3WdcXFBGY523DOJSX5uXjlYZjZjE6XzRSM/
I'm not sure how to test this exactly, maybe someone can fill me in on a way to force the email to send from a testing installation so we can see.
The new text is below. It's more focused, much shorter and more helpful.
There is an updated version of Joomla! available for
[SITENAME] - [URL]
Joomla! version currently installed: [CURVERSION]
Joomla! version available for installation: [NEWVERSION]
This email was automatically sent from your Joomla! website to notify you that a new version of Joomla! is available.
To install updates on your website please visit the following link:
[LINK]
If the URL is not a link, simply copy & paste it to your browser
This message is sent to [SITENAME] administrators by the Joomla! Update Notification system plugin and is intended to help you. Keeping your software up to date helps keep your website stay secure. It is recommended to install the update as soon as possible.
You can disable these update email notifications by disabling the Joomla! Update Notification system plugin, located in the Plugin Manager of your website administrator area:
Extensions - Plugins - System - Joomla! Update Notification
More information:
System - Joomla! Update Notification: https://docs.joomla.org/J3.x:Plugin_Joomla_Update_Notification Updating Joomla!: https://docs.joomla.org/J3.x:Updating_Joomla_(Update_Method)
If you are not sure why you received this email contact your website administrator
If you have questions, you can visit the Joomla! Support Forum: https://forum.joomla.org/
We should add a piece of documentation to link this email to, there is no documentation for this feature currently. It could be used to provide more useful links to other docs, like installation and update info, and the disclaimers if they are necessary.
Status | New | ⇒ | Pending |
Category | ⇒ | Administration Language & Strings |
Milestone |
Added: |
In any case case there should be no return in the ini file as it may trick some localisation translating systems/ extensions.
Sure, I'm simply keeping it readable until the text is finalized, it's easy enough to remove the white space. I'll try and test it and rework it today.
Labels |
Added:
?
?
|
Why did you delete the XML_DESCRIPTION string?
Because it's in en-GB.plg_system_updatenotification.sys.ini along with the label tag. The string is only used once and the sys.ini renders it.
I'm not sure why it needs to be in both files unless I'm missing something. If I am missing something, please let me know what it is. I thought it might be there for a reason, but I couldn't find that reason. The description still displays in plugin interface.
@franz-wohlkoenig I need to add a piece of documentation and a help screen in docs for this plugin so I have a link in the email, then it's ready to test.
@ot2sen That sounds about right. My guess is it's related to the installation process somehow but I don't know for sure. It's the same in other files so it has to be there for a reason, I just never noticed that before.
I've still got some work to do on this and I'll fix it up.
This is getting there. I'd like to get some feedback on the new text, the description has been updated with the most current version. I'm not 100% on it yet, it probably needs a revision or two.
I added a new jdocs page and included the new URL in the email: https://docs.joomla.org/J3.x:Plugin_Joomla_Update_Notification
We can put any necessary or additional information in the jdoc. Ideally the email text will be as light as possible while providing access to our community resources. Any feedback is appreciated.
I've updated the text. I'm not having any luck testing this on my local machine for some reason, maybe someone else can check.
Text should read:
There is an updated version of Joomla! available for [SITENAME] - [URL]
Joomla! version currently installed: [CURVERSION] Joomla! version available for installation: [NEWVERSION]
Visit the following link to apply the update:
[LINK] If the URL is not a link, simply copy & paste it to your browser
This message is automatically sent to [SITENAME] administrators by the Joomla! Update Notification system plugin when a new version of Joomla! is available. It is recommended to apply this update as soon as possible. Keeping your website software current to helps your website stay secure.
You can disable these notifications by disabling the Joomla! Update Notification system plugin located in the Plugin Manager of your website administrator area: Extensions - Plugins - System - Joomla! Update Notification.
Additional Information:
System - Joomla! Update Notification: https://docs.joomla.org/J3.x:Plugin_Joomla_Update_Notification
Updating Joomla!: https://docs.joomla.org/J3.x:Updating_Joomla_(Update_Method)
If you are not sure why you received this email contact your website administrator or visit the Joomla! Support Forum for further assistance: https://forum.joomla.org/
Joomla! version available for installation: [NEWVERSION]
.
Move it onto its own line.
If the URL is not a link, simply copy & paste it to your browser
Move it onto its own line. Add period.
Keeping your website software current to helps your website stay secure.
Remove to
.
If you are not sure why you received this email
Add comma.
This isnt a positive change as it removes the emphasis that the email is NOT being sent by Joomla but by your own web site. Furthermore the sentence "This message is automatically sent to [SITENAME] administrators by the Joomla! Update Notification system plugin when a new version of Joomla! is available" is completely ambiguous and uses terminology that a site owner may not understand and certainly is not clear that it is NOT being sent by joomla.org.
The current notice right at the top of the email "This email IS NOT sent by Joomla.org. It is sent automatically by your own site,\n[SITENAME]" was not something that was just imagined. It was the result of several years of modifications of an email sent to thousands of site owners by an extension.
I dont care about the rest of the text but that sentence must stay right at the top and be absolutely clear that Joomla.org is not sending the email.
Milestone |
Added: |
Milestone |
Removed: |
Milestone |
Removed: |
Milestone |
Added: |
Milestone |
Added: |
Milestone |
Removed: |
Milestone |
Removed: |
Milestone |
Added: |
Milestone |
Added: |
Milestone |
Removed: |
Milestone |
Removed: |
Milestone |
Added: |
Milestone |
Added: |
Milestone |
Removed: |
@chrisdavenport one more for the en-GB team to discuss
Milestone |
Added: |
Milestone |
Removed: |
I am closing this at this time as there are requested changes that have not been addressed and the en-gb team has not responded.
Status | Pending | ⇒ | Closed |
Closed_Date | 0000-00-00 00:00:00 | ⇒ | 2017-09-09 14:32:34 |
Closed_By | ⇒ | brianteeman |
I think it's a terrible pity that this discussion was shutdown and that the suggested changes were not considered. I agree with @cpfeifer that the current text is too abrasive in its tone and it discourages productive participation on the forum. I am well acquainted with the criticisms about the System - Update Notification plugin and the tendency by many site owners to disable the plugin in preference to being notified about the existence of new releases.
I also think we should be encouraging more people to use the System - Update Notification plugin instead of being "turned off" by the language being used.
I accept that this PR was sidelined from J! 3.8.0 because of a lack of feedback from the en-gb team but I would also request that the team revisit the matter, at least before the end of J! 3.8.x. Language matters.
Status | Discussion | ⇒ | New |
Closed_Date | 0000-00-00 00:00:00 | ⇒ |
Status | New | ⇒ | Pending |
Status | Closed | ⇒ | Discussion |
Closed_Date | 2017-09-09 14:32:34 | ⇒ | |
Closed_By | brianteeman | ⇒ |
reopened as stated above (last Paragraph).
Set to "open" on behalf of @franz-wohlkoenig by The JTracker Application at issues.joomla.org/joomla-cms/13942
three months later there has been no update so I am closing it once again
Status | Pending | ⇒ | Closed |
Closed_Date | 0000-00-00 00:00:00 | ⇒ | 2018-01-04 17:42:25 |
Closed_By | ⇒ | brianteeman |
There are different ways. The easyiest should be the following: