Joomla 3.x til 4.x Trin for trin migrering

Følgende er trin-for-trin instruktioner til at migrere dit 3.10.x-websted til Joomla! 4.x. Selvom der er forskellige scenarier, vil dette give dig den grundlæggende procedure, du skal følge. Komplekse migreringer vil sandsynligvis være et resultat af installeret tredje- partiudvidelser. Du opfordres til at kontakte udviklerne af tredjepartsudvidelser installeret på dit Joomla-websted for deres foreslåede migreringssti.

Advarsel!

Denne vejledning antager, at du starter på Joomla 3.10.x. Hvis du er på en tidligere version, skal du sørge for at opgradere til Joomla 3.10 først, før du flytter til Joomla 4. Der er ingen hast. Sørg for, at alle dine udvidelser er klar til Joomla 4.x . Joomla 3.10.x vil blive understøttet indtil 16. august 2023.

Intro

Migreringen fra Joomla! 3.10.x til 4.x betragtes som en minimigrering. Dette skyldes, at Joomla-kerneudvidelserne vil opgradere med en "one-click"-opgradering via Joomla! Update-komponenten i Backend (Administrator) af Joomla .Mange tredjepartsudvidelser er også en opgradering med et enkelt klik. Nogle er det ikke. Se på hver enkelt og afgør, hvilken vej udvidelsen skal følge for at komme fra 3.10 til 4.x. Vurdering og planlægning for 3.10 til 4.x - migrering før du følger nedenstående trin.
Joomla! Core Extensions er:

Kategorier
Artikler
Menuer
Moduler (kernemoduler - ikke tredjepart)
Handlingslogs
Bannere
Felter
Indholdshistorie
Kontaktpersoner
Beskeder
Nyhedsfeeds
Omdirigere
Søg (afkoblet i 4.x. Eksisterende 3.x-websteder vil stadig migrere det. Vi anbefaler dog at bruge Smart Search fremover. Se bemærkninger under Vurder hver udvidelse)
Smart søgning
Tags
Weblinks (afkoblet, men dit websted bruger det muligvis, og det vil migrere. Se bemærkninger under Vurder hver udvidelse).

Trin for trin

Konfigurer et udviklingssted

Sørg for, at du kører den seneste Joomla 3.10.x-version, før du fortsætter.
Tag en sikkerhedskopi af dit live 3.10.x-websted. Du kan bruge et foreslået værktøj (se de foreslåede værktøjer nederst på siden), eller du kan gøre dette manuelt.
- Grundlæggende om sikkerhedskopiering til et Joomla!-websted
- Hvad er den bedste praksis for sikkerhedskopiering af websteder?
Sørg for, at dit miljø opfylder de tekniske krav til Joomla 4 .
Opret en ny database og ny bruger at gendanne dit 3.10.x-websted til.
Opret et teststed eller et byggeområde at arbejde i, og gendan sikkerhedskopien af dit 3.10.x-websted et af følgende steder:
- Et underdomæne.
- En undermappe.
- En lokal enhed. Joomla har en detaljeret vejledning om installation af XAMPP på XAMPP . Men WAMP , MAMP , LAMP er alle egnede alternativer.
- En ny hostingkonto på et midlertidigt domæne i roden. (Hvis du gerne vil skifte vært under migreringsprocessen).
  - Gendannelse af et websted på en lokal enhed Se Installation af Joomla lokalt og Opsætning af din arbejdsstation til Joomla-udvikling .
  - Gendannelse af et websted med et værktøj, der er angivet nederst på siden. (Læs udviklerdokumentationen).
På din testplacering skal du opdatere din Joomla! 3.10.x-instans til den seneste vedligeholdelsesudgivelse.
Sørg for, at du har det seneste databaseskema opdateret til den seneste version 3.10.x-version ved at gå til Extension Manager → Database- fanen. Hvis dit skema ikke er opdateret som i følgende billede, skal du klikke på knappen Ret :
Tøm papirkurven: Har du nogen artikler i papirkurven? Slet dem (og eventuelle tilknyttede medier, hvis de ikke er i brug andre steder på webstedet). Artikler (også kategorier og menupunkter) efterladt i papirkurven kan forårsage migreringsproblemer.
Prøve.
Sikkerhedskopier igen.

Vurder hver udvidelse

I din planlægning fastslog du, at tredjepartsudvidelser forbliver eller kører, og hvordan de migrerer. Til denne del af Trin for Trin, vil du bruge to forskellige sektioner af webstedet i udstrakt grad; Indtjekningskomponenterne forud for opdatering → Joomla! Opdatering og udvidelser → Administrer → Administrer . Du kommer til at se på hver enkelt udvidelse, der er installeret på dit websted. Du bestemmer, om de skal opdateres til den nyeste version eller afinstalleres. Flere detaljer i Pre-Update Check .

Brug af Pre-Update Check : For at bruge Pre-Update Check skal du indstille Joomla! Update komponenten til Joomla 4. For at gøre dette, følg:
Gå til Komponenter → Joomla Update . (Der skal stå, at der ikke er fundet opdateringer. Hvis det ikke gør det, skal du opdatere Joomla til den nyeste version (skal være 3.10.x) og teste. Foretag derefter en anden backup.) Klik på knappen Indstillinger ved øverste højre hjørne.
Vælg Joomla Next fra rullemenuen for Update Channel.
Klik på Gem og luk
Du vil derefter se din installerede Joomla-version, den seneste Joomla!-version og URL-adressen til opdateringspakken. Joomla viser dig kravene igen til Joomla 4. Hvis den markerer, at du enten har et inkompatibelt system eller udvidelser, vil det fortælle dig her 。 Brug et øjeblik på at gennemgå denne side.

Vigtig besked

Opdater IKKE til Joomla! 4 lige nu. Dette er kun for at forberede dine tredjepartsudvidelser og få webstedet kompatibelt med Joomla! 4.
Se på Pre-Update Check og Extension Pre-Update Check på fanen Pre-Update Check i Joomla Update komponenten. Hvis en udvidelse, der ikke er i din planlægning er angivet her, skal du tilføje den til din liste over udvidelser for at undersøge .
Hvis du migrerede fra Joomla! 2.5 til 3.x i fortiden, kan der være nogle resterende udvidelser, der skal ryddes op i. Følgende er ældre 2.5 eller 3.x udvidelser, der skal afinstalleres før opdatering til Joomla 4:
- plg_content_geshi
- PKG_JOOMLA
- Bluestork administrator skabelon
- Beez_20
- Beez5
- Atomar
1. Når det kommer til skabeloner, skal du afinstallere alle kerne-frontend- eller backend-skabeloner undtagen Protostar og Beez3 (webstedskabeloner) og Isis eller Hathor (administratorskabeloner). Bemærk, at Protostar ikke er kompatibel med Joomla 4. Ved migrering forsvinder det. Du skal har én skabelon valgt som "standard", og du kan bruge Protostar eller Beez 3. Protostar forsvinder ved migrering til Joomla 4.x.
2. Hvis du støder på andre filer, der skal afinstalleres, bedes du tilføje dem til denne side. Dette er en wiki, så alle kan tilføje til siden. På forhånd tak for din service.
Du vil bemærke taggene for, om en udvidelse er kompatibel eller ej. Disse tags fortæller generelt en sand historie, hvis de siger nej eller ja. Hvis de siger "Manglende kompatibilitetstag", betyder det, at udvidelsesudvikleren ikke brugte et tag i deres udvidelse, så vi ved ikke, om det er eller ikke er kompatibelt med Joomla 4. Tal med udvikleren for at bekræfte.
Opdater udvidelser : opdater eventuelle udvidelser, du vil beholde på dit websted. I Joomla! 3.10.x kan du gå til Extension Manager → fanen Opdater og klikke på Find opdateringer , der tilføjer et værktøjstip i kolonnen Version under fanen Administrer, hvilket giver nogle kompatibilitetsoplysninger fra backend. Denne funktionalitet understøtter kun udvidelser, der opdateres via fanen Extension Manager Update. Hvis du har installeret udvidelser, der ikke bruger Joomla-udvidelsesopdateringen, skal de vurderes manuelt som beskrevet nedenfor. Det samme gælder for disse udvidelser der har et værktøjstip. Du skal stadig tjekke pakketypen og migreringsstien med udvidelsesudvikleren for at bekræfte, hvordan du opgraderer/migrerer.
Undersøg og afinstaller Extensions Extensions: Gå til Extension Manager → Administrer
Klik på knappen Søgeværktøjer for at vise filterindstillingerne
Vælg Pakke i rullemenuen Vælg type .

Det anbefales at vælge Pakke først, fordi hvis der er noget, du skal afinstallere i en pakke, vil det automatisk afinstallere de tilknyttede moduler, plugins eller noget andet i pakken på én gang.
Afinstaller alle pakker, der ikke længere er nødvendige eller ikke vil migrere til Joomla 4.
Gentag denne proces med at gå gennem fanen Administrer for alle typer i rullemenuen: Komponent, Fil, Sprog, Bibliotek, Modul, Plugin og skabelon. Hvis forfatteren angiver Joomla! Project, så lad disse udvidelser være i fred. For alle andre, sørg for at afinstallere dem, der ikke er i brug eller ikke er kompatible med Joomla!4.x.

BEMÆRK! Du vil ikke være i stand til at afinstallere nogen skabelon, der er indstillet som standard. Vælg en Core-understøttet skabelon såsom Beez3 eller Protostar, og afinstaller derefter skabelonen, hvis du har brug for det. En anden påmindelse: Protostar er ikke kompatibel med Joomla
4 . x . Ved migrering vil den forsvinde. Hvis du vælger den som standard, kommer du blot til Joomla 4.x.
Noter alle versioner af pakker og komponenter, der kører i øjeblikket, som du vil beholde på dit websted. Du kan kopiere/indsætte dem i et dokument til reference.
For eventuelle udvidelser, du beholder, men brug ikke Extension Manager til at opdatere med et enkelt klik ( Udvidelser → Administrer → Opdater ), opdatere alle udvidelser til de nyeste versioner.
Før og efterhånden som du opdaterer, skal du bemærke, om udvidelserne har både 3.10.x og 4.x versioner i den samme pakke. Hvis det er tilfældet, vil de være fint til at "update med et enkelt klik." Hvis ikke, og 3.10 og 4.x har forskellige pakker, se på dem fra sag til sag. De vil normalt falde ind under et af følgende scenarier:
- Udvidelsen har separate pakker, men ved opgradering til 4.x registrerer de dette automatisk og virker stadig. Sørg for, at udvikleren bekræfter dette.
- Udvidelsen har separate pakker, der skal afinstalleres i 3.10.x og derefter installeres med Joomla 4.x-versionen, når siden er migreret. Et eksempel på dette kan være et indholdsplugin. Det er nemt at afinstallere det i 3.10.x og installer det derefter igen i 4.x.
- Se skabelonovervejelser for mere specifik information om skabeloner og konvertering af en tidligere Joomla!-versionsskabelon

Noter om søgning (com_search)

Search (com_search) vil blive afkoblet i Joomla 4.x. Search (com_search) vil migrere til Joomla 4. Efter migrering skal du opdatere den til Joomla 4.x versionen via com_installer. Den vil fortsat blive vedligeholdt, men mere på samme måde som en tredjepartsudvidelse er ved at modtage opdateringer via com_installer. Det anbefales at bruge Smart Search (com_finder) fremover. Søgning vil stadig være tilgængelig på https://extensions.joomla.org/category/official- udvidelser/ .

Noter om weblinks

Weblinks blev afkoblet tilbage i Joomla 3.4. Hvis det var i brug på et 2.5-websted, ville migreringsprocessen bemærke dette og migrere Weblinks-komponenten og data. For migreringen fra 3.10.x til 4.x vil det være det samme. Den er stadig tilgængelig og vedligeholdt på JED'en i officielle udvidelser .

Bemærkninger om ældre routing

Legacy routing vil ikke være tilgængelig i Joomla 4.x. Kun Modern vil være tilgængelig. Når du foretager migreringen, hvis du bruger Legacy routing, vil systemet automatisk ændre dem til Modern routing. Du vil gerne køre en brudt linkchecker på dit websted efter migrering til Joomla 4.x og før du går live .

Går til Joomla! 4.x

Når du enten har opdateret eller afinstalleret dine tredjepartsudvidelser, så kun dem, der er kompatible med Joomla! 4, forbliver i din installation, skal du fortsætte med følgende trin:

Gå til System → Global konfiguration → fanen Server og drej Fejlrapportering fra Systemstandard til Maksimum. Sørg for at gemme og lukke.
Tag en anden backup.
Gå til Komponenter → Joomla Update (Der skulle stå ingen opdateringer fundet. Hvis ikke, opdater Joomla til den nyeste version og test. Foretag derefter en anden backup.) Klik på knappen Indstillinger i øverste højre hjørne.
Vælg Joomla Next fra rullemenuen for Update Channel.
Klik på Gem og luk.
Du vil derefter se din installerede Joomla-version, den seneste Joomla!-version og URL'en til opdateringspakken. Joomla viser dig kravene igen til Joomla 4. Hvis den markerer, at du enten har et inkompatibelt system eller udvidelser, vil det fortælle dig her 。 Brug et øjeblik på at gennemgå denne side.
Hvis opdateringen ikke vises, skal du gå til Extension manager → Opdater og trykke på Purge Cache fra værktøjslinjen. Nu skulle opdateringen til Joomla!4 dukke op.
Kryds fingre, og sørg for, at du har den backup tilgængelig i tilfælde af.
Klik på knappen Installer opdateringen.
Lav te, mens statuslinjen indlæses til helt grøn. Hvor lang tid det tager afhænger af dit websted, internetforbindelse og serverhastighed. Processen tager omkring to minutter. Når opdateringen er færdig, vil du sandsynligvis blive logget ud af Administrator. Log ind igen. To gange.
Hvis alt går godt, får du et helt nyt udseende til Backend-panelet.
Gå til System → Vedligeholdelse → Database , og klik på Fix , hvis der vises nogen fejl.
I System → Installer → Find ud af, om der er nogen udvidelser at installere. (Der burde ikke være nogen!)
Gå til frontend på dit websted og se, om det dukker op, selvom det ikke er den rigtige skabelon. Hvis ja, fortsæt. Hvis ikke, kan du se almindelige fejl under migreringen .
Tag en backup.
Installer din nye skabelon eller andre udvidelser, hvis du skal installere dem. Sikkerhedskopier ofte.
Konfigurer dem. Sikkerhedskopier ofte.
Kør en brudt link-kontrol og ret eventuelle ødelagte links.
Test alt. Sikkerhedskopier ofte.
Hvis alt fungerer som forventet, skal du vende Fejlrapportering tilbage til System Default ( System → Global Configuration → Server fanen ). Sørg for at Gem og luk.

Gå live med dit Joomla! 4.x-websted

Når du er klar til at gå live, skal du sikkerhedskopiere dit 3.10-websted for sidste gang. Gendan det i en undermappe eller et underdomæne, hvis du vil.
Sikkerhedskopier dit Joomla! 4.x-websted og flyt eller gendan dit Joomla! 4.x-websted til roden (eller skift navneservere, hvis du byggede på et midlertidigt domæne ved en ny hostingkontorod).
Test igen.
Hvis du tidligere har foretaget sikkerhedsændringer i .htaccess- filen, skal du muligvis ændre en linje (eller linjer) i den for at opdatere til Joomla 4. Gå venligst til Htaccess-ændringer efter joomla4.0.4 for at afgøre, om du skal ændre din fil.
Fjern Joomla! 3.10-webstedet fra serveren inden for et par dage, medmindre du har redigeret din robots.txt- fil for at blokere søgemaskinespiders og deaktiveret frontenden af webstedet.
Fjern alle udviklingswebsteder, du har arbejdet med, eller hold dem opdaterede, hvis de kører en aktuel version for at afværge hackforsøg på din server.

Hvis du havde dataændringer på 3.10-webstedet, mens du migrerede til 4.x, vil du ønske at få disse data flyttet over til 4.x-webstedet, før du går live. Du kan gøre dette manuelt (sørg for at beholde den samme bruger ID'er - gå i rækkefølge) eller ved at bruge en tredjepartsudvidelse .

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