Difference between revisions of "Pre-Update Check"

From Joomla! Documentation

(Added an item to check that the site is on the Joomla Next Update Channel.)
(Just added an x)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
<noinclude><languages /></noinclude>
 
<noinclude><languages /></noinclude>
<translate><!--T:1--> New to Joomla! 3.10.x is the Pre-Update Check. This view of the Joomla Update component shows technical specifications of the server the site is on and core and third-party extensions that use the Update Server in a list form.</translate>
+
<translate><!--T:1--> In Joomla! 3.10.x and 4.4.x you can find a Pre-Update Check. This view of the Joomla Update component shows technical specifications of the server the site is on and core and third-party extensions that use the Update Server in a list form.</translate>
  
'''To navigate to the Update-screen:'''
+
[[J3.x:Pre-Update_Check|Pre-Update Check information for Joomla 3.10.x]]
*Click the 'Live Update' tab.
 
  
<translate>
+
[[J4.x:Pre-Update_Check|Pre-Update Check information for Joomla 4.4.x]]
<!--T:52-->
 
'''To navigate to the Pre-Update Check-screen:'''
 
*Click in the top bar {{rarr|Components,Joomla! Update}} menu item.
 
*If you don´t see the Pre-Update Check-screen, click on the '''Check for Updates''' button or clear cache and refresh the page.
 
*Also verify that the site is on the Joomla Next Update Channel. {{rarr|Administrator,Components,Joomla Update,Options,Update Channel}}. Select ''Joomla Next'', then ''Save & Close''.
 
</translate>
 
 
 
<translate>
 
== Technical Specifications == <!--T:2--></translate>
 
<translate>
 
<!--T:3-->
 
The top portion of the Pre-Update Check shows whether your current server environment is compatible with the current target version Joomla for both the required PHP and database settings. The data on the [https://downloads.joomla.org/technical-requirements Technical Requirements] page show the specs we are checking against.</translate>
 
 
 
[[File:php_and_database_settings-<translate><!--T:4--> en</translate>.png|border|800px|<translate><!--T:5--> Required PHP and Database Settings portion of the Pre-Update Check Component</translate>]]
 
[[File:Recommended_php_settings-<translate><!--T:42--> en</translate>.png|border|800px|<translate><!--T:43--> Recommended PHP Settings portion of the Pre-Update Check Component</translate>]]
 
 
 
<translate>
 
<!--T:6-->
 
What's important is to check if anything is red and not compatible with Joomla 4.x. If it isn't, you'll need to talk to your host or change hosts before migrating to Joomla 4.x. During a migration is a great time to change hosts. See the [[S:MyLanguage/Why Migrate|Migration Funnel]] for more information on planning and step-by-step instructions.</translate>
 
 
 
<translate>
 
== Extensions Pre-Update Check == <!--T:7--></translate>
 
<translate>
 
<!--T:8-->
 
The extension portion of the Pre-Update Check component pulls third-party extensions.</translate>
 
 
 
<translate>
 
<!--T:9-->
 
The list is broken into sections based on the ''targetplatform'' tag, the extensions you are or are not using. For developers, see [[S:MyLanguage/Deploying an Update Server|Deploying an Update Server]] for more information about these tags and how to deploy an Update Server. For more information about the Joomla Update System, see the [https://extensions.joomla.org/support/knowledgebase/submission-requirements/joomla-update-system-requirement/ Joomla! Update System Requirement] and [https://docs.joomla.org/Help39:Extensions_Extension_Manager_Update Extensions Extension Manager Update] pages.</translate>
 
 
 
<translate>
 
<!--T:10-->
 
By clicking the '''More Detail''' link to the right in each colour heading, you can see additional information about the extensions installed on your site.</translate>
 
 
 
[[File:pre_upgrade_checker_error-<translate><!--T:11--> en</translate>.png|border|800px|<translate><!--T:12--> Update Information Unaviable</translate>]]
 
 
 
<translate>
 
<!--T:13-->
 
The extensions listed here do not support yet the Joomla Update system or atleast do not have an targetplatform tag that indicates support for the selected target Joomla Version. (see [[Deploying an Update Server]]) Please contact the developer of the listed extensions to make sure they are compatible with 4.x</translate>
 
 
 
[[File:pre_upgrade_checker_warning-<translate><!--T:14--> en</translate>.png|border|800px|<translate><!--T:15--> Update Required</translate>]]
 
 
 
<translate>
 
<!--T:16-->
 
The extensions listed here require an update to work correctly on 4.x. Please contact the developer of the listed extensions to make sure whether you have to update the component before or after the upgrade.</translate>
 
 
 
[[File:pre_upgrade_checker_ok-<translate><!--T:17--> en</translate>.png|border|800px|<translate><!--T:18--> No Update Required</translate>]]
 
 
 
<translate>
 
<!--T:19-->
 
The extensions listed here claim to be 4.x compatible and no update is required.</translate>
 
 
 
<translate>
 
== What is it about that ''Potential Upgrade Issue'' == <!--T:44-->
 
 
 
<!--T:45-->
 
Plugins with the type ('system', 'user', 'authentication', 'actionlog', 'twofactorauth') could be triggered while we are processing the upgrade. When there is a critical issue within that plugins that could result into a broken upgrade and make the site unusable. For that reason any plugin from that type that is not explicite listed as compatible has to be even more carefully reviewed before you hit the upgrade button. It is '''strongly''' recommended to disable the plugins in question and to check with the original developer.</translate>
 
 
 
[[File:Pre_upgrade_checker_popup-<translate><!--T:46--> en</translate>.png|200px|<translate><!--T:53--> The popup warning for potencial upgrade issue</translate>]]
 
 
 
<translate><!--T:47-->
 
On the ''Live Update'' Tab you will be preseted again with the full list of potential breaking extensions.</translate>
 
 
 
[[File:Live_upgrade_tab_errors-<translate><!--T:48--> en</translate>.png|border|800px|<translate><!--T:54--> The Live Update message on potential breaking extensions</translate>]]
 
 
 
<translate><!--T:49-->
 
It is '''strongly''' recommended to disable all extensions including the plugins listed here before you run the upgrade because the extensions listed here seem not to be compatible with your target version but could break your upgrade.</translate>
 
 
 
<translate><!--T:50-->
 
You know what you are doing? You want to choose to ignore the warnings and run the upgrade anyway you can do so by checking the checkbox. As that is taking your site at risk of breaking without an easy recovery this is the last time to remind you to take a backup!</translate>
 
<translate>
 
== Questions and Answers == <!--T:20--></translate>
 
<translate>
 
<!--T:21-->
 
Let's break this down into some questions and answers.</translate>
 
 
 
<translate>
 
<!--T:22-->
 
'''Q: What do the tags mean?'''</translate>
 
 
 
<translate>
 
<!--T:23-->
 
A: The green '''No Update Required''' tag means that the extension has been tagged by the developer that the extension as ready for Joomla 4. It ''should'' migrate with the one-click from 3.10.x to 4.x. Verifying with the developer is suggested.</translate>
 
 
 
<translate>
 
<!--T:24-->
 
The red '''Update Information Unavailable''' tag means that the extension has not added compatibility information the extension. Check with the developer on the migration path from 3.10.x to 4.x.</translate>
 
 
 
<translate>
 
<!--T:25-->
 
The yellow/orange '''Yes (x.x.x)''' tag means that the extension has been tagged by the developer that the extension may need an update in order to be compatible with Joomla 4. Update the extension and see if it turns to a green Yes. If it doesn't, check with the developer on the migration path from 3.10.x to 4.x.</translate>
 
 
 
<translate>
 
<!--T:26-->
 
The gray '''Missing Compatibility Tag''' means that the extension doesn't have a tag '''or''' does not use the Update Server. The developer hasn't said yes or no or needs an update. In some cases, a package may have been installed and the component portion has a tag but the additional plugins or modules are missing tags. As always, you'll need to check with each extension developer to verify the migration path from 3.10.x to 4.x.</translate>
 
 
 
<translate>
 
<!--T:27-->
 
'''Q: What about the Joomla core components?'''</translate>
 
 
 
<translate>
 
<!--T:28-->
 
A: Joomla core extensions will migrate from 3.10.x to 4.x on the one-click with these exceptions:</translate>
 
 
 
<translate>
 
<!--T:29-->
 
The language packs are not yet ready for Joomla 4 (as of September 2020). Over time, they will be. If your site depends on other language packs, wait to migrate until all the language packs are ready.</translate>
 
 
 
<translate>
 
<!--T:30-->
 
The Weblinks component is not yet ready for Joomla 4 (as of September 2020). If you're going to continue using Weblinks in your Joomla 4 site, wait to migrate until the Weblinks component is ready.</translate>
 
 
 
<translate>
 
<!--T:31-->
 
'''Q: What about templates?'''</translate>
 
 
 
<translate>
 
<!--T:32-->
 
A: Because of the changes in Joomla 4, your template may or may not be compatible with Joomla 4. The core templates like Protostar, Beez3, Beez5, and so on will ''convert'' to the new Cassiopeia template on the one click and the older templates will be completely removed.</translate> <translate><!--T:33--> If you're using a club template from a third-party developer that is not compatible with Joomla 4, you'll need to change your default template to Protostar (or Beez3) before you do the one-click. If you have older administrator templates or core templates, it's recommended to uninstall all of them except whichever of the core templates you will set as default. This includes Bluestork, Hathor, the other beez templates. You will keep Isis as the administrator template. You will keep either your compatible third-party template, Protostar or Beez3 as default. You will uninstall the rest.</translate>
 
 
 
<translate>
 
<!--T:34-->
 
'''Q: Can I uninstall plg_content_geshi?'''</translate>
 
 
 
<translate>
 
<!--T:35-->
 
A: Yes. This is leftover from the 2.5 life cycle and '''must''' be uninstalled.</translate>
 
 
 
<translate>
 
<!--T:36-->
 
'''Q: What about all that FOF, fef, etc.?'''</translate>
 
 
 
<translate>
 
<!--T:37-->
 
A: Many extensions  in the red or yellow/orange headings '''will/may''' make it through the one-click and migrate fine. It is recommended that you go to Extensions→Manage→Manage and check all extensions. Typically the ones authored by Joomla will migrate on the one click. Typically the Akeeba extensions will too. Again, check with extension developers to verify the migration path on '''all''' third-party extensions.</translate>
 
 
 
<translate>
 
<!--T:38-->
 
'''Q: Does the Extensions Pre-Update Check show all the extensions installed on my site?'''</translate>
 
 
 
<translate>
 
<!--T:39-->
 
A: The Pre-Update Check will show all extensions. Only extensions that use the Update Server are given compatibility information. Those extensions that do not use the Update Server will show in the list with the '''Missing Compatibility Tag'''.</translate>
 
 
 
<translate>
 
== Summary == <!--T:40--></translate>
 
<translate>
 
<!--T:41-->
 
From a migration perspective, it is my belief that the Pre-Update Check should be used a guide. You'll want to have a second tab open with ''Extensions→Manage→Manage'' open in order to uninstall any extensions or check who they're authored by so you can contact third-party extension developers on the migration path they've established to migrate their extensions.</translate>
 
  
 
<noinclude>
 
<noinclude>
Line 160: Line 10:
 
<!--T:51-->
 
<!--T:51-->
 
[[Category:Joomla!_4.x]]
 
[[Category:Joomla!_4.x]]
 +
[[Category:Joomla!_5.x]]
 
[[Category:Version 4.x FAQ]]
 
[[Category:Version 4.x FAQ]]
 +
[[Category:Version 5.x FAQ]]
 
</translate>
 
</translate>
 
</noinclude>
 
</noinclude>

Latest revision as of 15:23, 4 October 2023

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français • ‎中文(繁體)‎ • ‎日本語

In Joomla! 3.10.x and 4.4.x you can find a Pre-Update Check. This view of the Joomla Update component shows technical specifications of the server the site is on and core and third-party extensions that use the Update Server in a list form.

Pre-Update Check information for Joomla 3.10.x

Pre-Update Check information for Joomla 4.4.x