Joomla 3.x na 4.x Stap-vir-stap migrasie

Die volgende is stap-vir-stap instruksies om jou 3.10.x-werf na Joomla! 4.x te migreer. Alhoewel daar verskillende scenario's is, sal dit jou die basiese prosedure gee om te volg. Komplekse migrasies sal waarskynlik die gevolg wees van geïnstalleerde derde- party-uitbreidings Jy word aangemoedig om die ontwikkelaars van derdeparty-uitbreidings wat op jou Joomla-werf geïnstalleer is, te kontak vir hul voorgestelde migrasiepad.

Waarskuwing!

Hierdie gids neem aan dat jy met Joomla 3.10.x begin. As jy op 'n vroeër weergawe is, maak seker dat jy eers na Joomla 3.10 opgradeer voordat jy na Joomla 4 beweeg. Daar is geen haas nie. Maak seker dat al jou uitbreidings gereed is vir Joomla 4.x Joomla 3.10.x sal tot 16 Augustus 2023 ondersteun word.

Inleiding

Die migrasie van Joomla! 3.10.x na 4.x word as 'n minimigrasie beskou. Dit is omdat die Joomla-kernuitbreidings met 'n "een-klik" opgradering sal opgradeer via die Joomla! Update-komponent in die agterkant (Administrateur) van Joomla .Baie derdeparty-uitbreidings is ook 'n opgradering met een klik. Sommige is nie. Kyk na elkeen en bepaal watter pad die uitbreiding moet volg om van 3.10 tot 4.x te kom. Assessering en beplanning vir 3.10 tot 4.x - migrasie voordat jy die stappe hieronder volg.
Joomla! Kernuitbreidings is:

Kategorieë
Artikels
Spyskaarte
Modules (kernmodules - nie derdeparty nie)
Aksie logs
Baniere
Velde
Inhoud Geskiedenis
Kontakte
Boodskappe
Nuusvoere
Herlei
Soek (ontkoppel in 4.x. Bestaande 3.x-werwe sal dit steeds migreer. Ons beveel egter aan dat jy Slim Soek vorentoe gebruik. Sien Notas onder Assesseer elke uitbreiding)
Slim soektog
Merkers
Webskakels (ontkoppel maar jou werf gebruik dit dalk en dit sal migreer. Sien Notas onder Assesseer elke uitbreiding.)

Stap vir stap

Stel 'n ontwikkelingsligging op

Maak seker dat jy die nuutste Joomla 3.10.x-weergawe gebruik voordat jy voortgaan.
Neem 'n rugsteun van jou lewendige 3.10.x-werf. Jy kan 'n voorgestelde hulpmiddel gebruik (sien die Voorgestelde nutsgoed onderaan die bladsy) of jy kan dit met die hand doen.
- Backup Basics vir 'n Joomla!-webwerf
- Wat is die beste praktyke vir werfrugsteun?
Maak seker jou omgewing voldoen aan die tegniese vereistes vir Joomla 4 .
Skep 'n nuwe databasis en nuwe gebruiker om jou 3.10.x-werf na te herstel.
Skep 'n toetswerf of bouarea om in te werk en herstel die rugsteunkopie van jou 3.10.x-werf op een van die volgende plekke:
- 'n Subdomein.
- 'n Subgids.
- 'n Plaaslike toestel. Joomla het 'n gedetailleerde tutoriaal oor die installering van XAMPP by XAMPP . WAMP , MAMP , LAMP is egter almal geskikte alternatiewe.
- 'n Nuwe gasheerrekening op 'n tydelike domein in die wortel. (As jy gasheer wil verander in die proses van migrasie.)
  - Herstel van 'n webwerf op 'n plaaslike toestel. Sien Installeer Joomla plaaslik en Stel jou werkstasie op vir Joomla-ontwikkeling .
  - Herstel van 'n werf met 'n instrument wat onderaan die bladsy gelys is. (Lees die ontwikkelaardokumentasie.)
In jou toetsligging, dateer jou Joomla! 3.10.x-instansie op na die jongste instandhoudingsvrystelling.
Maak seker dat jy die nuutste databasisskema opgedateer het na die nuutste weergawe 3.10.x-weergawe deur na Uitbreidingsbestuurder → Databasis- oortjie te gaan. As jou skema nie op datum is soos in die volgende prent nie, klik die Herstel -knoppie:
Leë asblik: Het jy enige artikels in die asblik? Vee hulle uit (en enige geassosieerde media as dit nie elders op die werf gebruik word nie). Artikels (kategorieë en spyskaart-items ook) wat in die asblik gelaat word, kan migrasieprobleme veroorsaak.
Toets.
Rugsteun weer.

Evalueer elke uitbreiding

In jou beplanning het jy vasgestel dat derdeparty-uitbreidings bly of aangaan en hoe hulle migreer. Vir hierdie gedeelte van die Stap-vir-stap, sal jy twee verskillende afdelings van die werf op groot skaal gebruik; Die Voor-opdatering Check-in- komponente → Joomla! Opdateer en uitbreidings → Bestuur → Bestuur . Jy gaan kyk na elke enkele uitbreiding wat op jou werf geïnstalleer is. Jy sal bepaal of dit opgedateer moet word na die nuutste weergawe of gedeïnstalleer moet word. Meer besonderhede in Voor- opdateringkontrole .

Die gebruik van die Pre-Update Check : om die Pre-Update Check te gebruik, sal jy die Joomla! Update komponent op Joomla 4 moet stel. Om dit te doen volg:
Gaan na Components → Joomla Update . (Dit behoort te sê geen opdaterings gevind nie. Indien dit nie is nie, dateer Joomla op na die nuutste weergawe (moet 3.10.x wees) en toets. Doen dan nog 'n rugsteun.) Klik op die Options-knoppie by die regter boonste hoek.
Kies Joomla Volgende in die aftreklys vir Update Channel.
Klik op Stoor en maak toe
Jy sal dan jou geïnstalleerde Joomla-weergawe, die nuutste Joomla!-weergawe en die URL vir die opdateringspakket sien. Joomla sal jou weer die vereistes vir Joomla 4 wys. As dit vlag dat jy óf 'n onversoenbare stelsel óf uitbreidings het, sal dit jou hier vertel 。 Neem 'n oomblik om hierdie bladsy te hersien.

Belangrike kennisgewing

MOENIE op die oomblik na Joomla! 4 opdateer nie. Dit is slegs om jou derdeparty-uitbreidings voor te berei en die werf versoenbaar te maak met Joomla! 4.
Kyk na die Pre-Update Check en die Extension Pre-Update Check in die Pre-Update Check blad van die Joomla Update komponent. As enige uitbreiding wat nie in jou beplanning is nie hier gelys is, voeg dit by jou lys van uitbreidings om te ondersoek .
As jy in die verlede van Joomla! 2.5 na 3.x migreer het, is daar dalk 'n paar oorblywende uitbreidings wat skoongemaak moet word. Die volgende is ouer 2.5 of 3.x uitbreidings wat gedeïnstalleer moet word voordat jy na Joomla 4 bywerk:
- plg_content_geshi
- PKG_JOOMLA
- Bluestork Administrateur Sjabloon
- Beez_20
- Bees5
- Atoom
1. Wanneer dit by sjablone kom, verwyder alle kern-voorkant- of agterkant-sjablone behalwe Protostar en Beez3 (werfsjablone) en Isis of Hathor (Administrateursjablone). Let wel Protostar is nie versoenbaar met Joomla 4 nie. Na migrasie sal dit verdwyn. Jy sal moet het een sjabloon gekies as "verstek" en jy kan Protostar of Beez3 gebruik Protostar sal verdwyn met migrasie na Joomla 4.x.
2. As jy ander lêers teëkom wat gedeïnstalleer moet word, voeg dit asseblief by hierdie bladsy. Hierdie is 'n wiki sodat enige iemand by die bladsy kan byvoeg. Byvoorbaat dankie vir jou diens.
Jy sal die etikette sien of 'n uitbreiding versoenbaar is of nie. Hierdie etikette vertel gewoonlik 'n ware storie as hulle Nee of Ja sê. As hulle sê "Ontbrekende versoenbaarheidsmerker" beteken dit dat die uitbreidingsontwikkelaar nie 'n merker in hul uitbreiding sodat ons nie weet of dit met Joomla 4 versoenbaar is of nie. Praat met die ontwikkelaar om te verifieer.
Dateer uitbreidings op : dateer enige uitbreidings op wat jy op jou webwerf sal hou In Joomla! 3.10.x kan jy na Uitbreidingbestuurder → Opdateer-oortjie gaan en op Soek opdaterings klik wat 'n nutswenk in die Weergawe-kolom sal byvoeg, onder die Bestuur-oortjie, wat 'n paar gee versoenbaarheidsinligting vanaf die agterkant. Hierdie funksionaliteit ondersteun slegs uitbreidings wat opdateer via die Uitbreidingsbestuurder-opdatering-oortjie. As jy uitbreidings geïnstalleer het wat nie die Joomla-uitbreidingsopdatering gebruik nie, moet hulle handmatig geassesseer word soos hieronder uiteengesit. Dieselfde geld vir hierdie uitbreidings wat 'n nutswenk het. Jy sal steeds die tipe pakket en migrasiepad met die uitbreidingsontwikkelaar moet kontroleer om te verifieer hoe om op te gradeer/migreer.
Ondersoek en verwyder uitbreidingsuitbreidings: gaan na Uitbreidingsbestuurder → Bestuur
Klik op die Button Search Tools om die filteropsies te wys
Kies Pakket uit die Kies tipe aftreklys.

Dit word aanbeveel om eers Pakket te kies, want as daar iets is wat jy in 'n pakket moet deïnstalleer, sal dit outomaties die geassosieerde modules, plugins of enigiets anders in die pakket op een slag verwyder.
Verwyder enige pakkette wat nie meer nodig is nie of wat nie na Joomla 4 sal migreer nie.
Herhaal hierdie proses om deur die Bestuur-oortjie te gaan vir alle tipes in die aftreklys: Komponent, Lêer, Taal, Biblioteek, Module, Inprop en Sjabloon. As die outeur Joomla! Projek noem, laat dan daardie uitbreidings uit. Vir alle ander, maak seker dat jy dié wat nie gebruik word nie of nie versoenbaar is met Joomla!4.x, verwyder nie.

LET WEL! Jy sal nie enige sjabloon wat as verstek gestel is, kan deïnstalleer nie. Kies 'n Kernondersteunde sjabloon soos Beez3 of Protostar en deïnstalleer dan die sjabloon as jy dit moet doen. Nog 'n herinnering: Protostar is nie versoenbaar met Joomla 4
nie . x . Met migrasie sal dit verdwyn. As u dit as verstek kies, bring u eenvoudig na Joomla 4.x.
Maak 'n aantekening van enige weergawes van pakkette en komponente wat tans loop wat jy op jou werf gaan hou. Jy kan dit kopieer/plak in 'n dokument vir verwysing.
Vir enige uitbreidings wat jy behou, maar moenie die Uitbreidingsbestuurder gebruik om een-klik op te dateer nie ( Uitbreidings → Bestuur → Dateer op ) alle uitbreidings op te dateer na die nuutste weergawes.
Voor en terwyl jy opdateer, let op of die uitbreidings beide 3.10.x- en 4.x-weergawes in dieselfde pakket het. Indien wel, sal dit goed wees om "een-klik op te dateer." Indien nie, en 3.10 en 4.x het verskillende pakkette, kyk van geval tot geval daarna. Hulle sal normaalweg in een van die volgende scenario's val:
- Die uitbreiding het aparte pakkette, maar met die opgradering na 4.x, bespeur hulle dit outomaties en werk steeds. Maak seker dat die ontwikkelaar dit bevestig.
- Die uitbreiding het aparte pakkette wat in 3.10.x gedeïnstalleer moet word en dan met die Joomla 4.x-weergawe geïnstalleer moet word sodra die werf gemigreer is. 'n Voorbeeld hiervan kan 'n inhoudinprop wees. Dit is maklik om dit in 3.10.x te deïnstalleer en installeer dit dan weer in 4.x.
- Sien Sjabloonoorwegings vir meer spesifieke inligting oor sjablone en die omskakeling van 'n vorige Joomla!-weergawe-sjabloon

Notas oor soektog (com_search)

Search (com_search) sal ontkoppel word in Joomla 4.x. Search (com_search) sal migreer na Joomla 4. Na migrasie sal jy dit moet opdateer na die Joomla 4.x weergawe via com_installer. Dit sal steeds onderhou word, maar meer op dieselfde manier as 'n derdeparty-uitbreiding deur opdaterings via com_installer te ontvang. Dit word aanbeveel om voortaan Smart Search (com_finder) te gebruik. Soek sal steeds beskikbaar wees by https://extensions.joomla.org/category/official- uitbreidings/ .

Notas oor webskakels

Webskakels is teruggekoppel in Joomla 3.4. As dit op 'n 2.5-werf in gebruik was, sou die migrasieproses dit opmerk en die Webskakel-komponent en -data migreer. Vir die migrasie van 3.10.x na 4.x, sal dit dieselfde wees. Dit is steeds beskikbaar en onderhou op die JED by Amptelike Uitbreidings .

Notas oor verouderde roetes

Verouderde roetering sal nie in Joomla 4.x beskikbaar wees nie. Slegs Modern sal beskikbaar wees. Wanneer jy die migrasie doen, as jy Legacy roetering gebruik, sal die stelsel dit outomaties verander na Moderne roetering. Jy sal 'n gebroke skakelkontroler wil laat loop op jou werf nadat jy na Joomla 4.x migreer en voor jy regstreeks gaan .

Gaan na Joomla! 4.x

Sodra jy jou derdeparty-uitbreidings opgedateer of gedeïnstalleer het sodat net dié wat met Joomla!4 versoenbaar is in jou installasie bly, gaan voort met die volgende stappe:

Gaan na Stelsel → Globale opstelling → Bediener-oortjie en verander Foutverslaggewing van Stelselverstek na Maksimum. Maak seker dat jy Stoor en Maak toe.
Neem nog 'n rugsteun.
Gaan na Components → Joomla Update .(Dit behoort te sê geen opdaterings gevind nie. Indien dit nie gebeur nie, dateer Joomla op na die nuutste weergawe en toets. Doen dan nog 'n rugsteun.) Klik op die Options-knoppie in die regter boonste hoek.
Kies Joomla Volgende in die aftreklys vir Update Channel.
Klik op Stoor en maak toe.
Jy sal dan jou geïnstalleerde Joomla-weergawe, die nuutste Joomla!-weergawe en die URL vir die opdateringspakket sien. Joomla sal jou weer die vereistes vir Joomla 4 wys. As dit vlag dat jy óf 'n onversoenbare stelsel óf uitbreidings het, sal dit jou hier vertel 。 Neem 'n oomblik om hierdie bladsy te hersien.
As die opdatering nie verskyn nie, gaan na Uitbreidingbestuurder → Werk en druk Purge Cache vanaf die nutsbalk. Nou behoort die opdatering na Joomla!4 te verskyn.
Kruis jou vingers en maak seker dat jy daardie rugsteun beskikbaar het vir ingeval.
Klik op die Installeer die Update-knoppie.
Maak tee terwyl die statusbalk heeltemal groen laai. Die hoeveelheid tyd wat dit neem hang af van jou werf, internetverbinding en bedienerspoed. Die proses neem ongeveer twee minute. Wanneer die opdatering voltooi is, sal jy waarskynlik afgemeld word by die Administrateur. Meld weer aan. Twee keer.
As alles goed gaan, sal jy 'n heeltemal nuwe voorkoms vir die Backend-paneel kry.
Gaan na Stelsel → Onderhoud → Databasis en klik Regstel indien enige foute wys.
Kyk in Stelsel → Installeer → Ontdek of daar enige uitbreidings is om te installeer. (Daar behoort nie enige te wees nie!)
Gaan na die voorkant van jou werf en kyk of dit verskyn selfs al is dit nie die regte sjabloon nie. Indien wel, gaan voort. Indien nie, sien algemene foute tydens migrasie .
Neem 'n rugsteun.
Installeer jou nuwe sjabloon of ander uitbreidings as jy dit het om te installeer. Rugsteun gereeld.
Stel hulle op. Rugsteun gereeld.
Begin 'n gebroke skakeltoetser en maak enige gebroke skakels reg.
Toets alles. Rugsteun gereeld.
As alles werk soos verwag, draai Foutrapportering terug na Stelselverstek ( Stelsel → Globale opstelling → Bediener-oortjie ). Maak seker dat jy stoor en toemaak.

Gaan regstreeks met jou Joomla! 4.x-werf

Rugsteun jou 3.10-werf vir oulaas wanneer jy gereed is om regstreeks te gaan. Herstel dit in 'n subgids of subdomein as jy wil.
Rugsteun jou Joomla! 4.x-werf en skuif of herstel jou Joomla! 4.x-werf na die wortel (of verander naambedieners as jy op 'n tydelike domein by 'n nuwe gasheerrekening se wortel gebou het).
Toets weer.
As jy in die verlede sekuriteitsveranderinge aan .htaccess- lêer aangebring het, sal jy dalk 'n reël (of reëls) daarin moet verander om na Joomla 4 op te dateer. Gaan asseblief na Htaccess-veranderinge na joomla4.0.4 om te bepaal of jy jou lêer.
Verwyder die Joomla! 3.10-werf binne 'n paar dae van die bediener af, tensy jy jou robots.txt- lêer gewysig het om die soekenjinspinnekoppe te blokkeer en die Frontend van die werf gedeaktiveer het.
Verwyder alle ontwikkelingswebwerwe waarmee jy gewerk het of hou hulle op datum as hulle 'n huidige weergawe gebruik om hackpogings op jou bediener af te weer.

As jy dataverandering op die 3.10-werf gehad het terwyl jy na 4.x migreer het, sal jy daardie data na die 4.x-werf wil laat oorskuif voordat dit regstreeks gaan. Jy kan dit met die hand doen (maak seker dat jy dieselfde gebruiker behou ID's - gaan in volgorde) of deur 'n derdeparty-uitbreiding te gebruik .

Docs.joomla.org

An online collaborative community manual for Joomla! users, developers or anyone interested in learning more about Joomla! Currently, we have more than 9,000 articles written, maintained, and translated by our Joomla! community members.

Original article : https://docs.joomla.org/Joomla_3.x_to_4.x_Step_by_Step_Migration