Veiledning

Flytt et Statamic-nettsted over til Aurora

Et skrivebord sett ovenfra med laptop, skisser, telefon og bøker

Statamic og Aurora er begge Laravel-pakker, så et Statamic-nettsted flyttes over til Aurora i sitt eget prosjekt. Aurora installeres ved siden av Statamic, nettstedet bygges opp på nytt i Aurora mens Statamic fortsatt viser det, og Statamic går når alt er kommet over. En KI-kodeagent kan gjøre det meste av jobben: Aurora leveres med en skill som kjenner veien.

1. Installer Aurora ved siden av Statamic

Du trenger Statamic 6 på Laravel 13 og PHP 8.4, og Aurora 1.3.4 eller nyere. Jobb på en egen gren i prosjektet.

~ Terminal

$ composer require shipaurora/cms
$ php artisan aurora:install
$ php artisan boost:install   # choose shipaurora/cms when it asks

Statamics kontrollpanel blir værende på /cp, og Auroras admin er på /admin. Så lenge Statamics ruter er på, viser Statamic fortsatt nettstedet, og du ser Aurora-sidene i den visuelle editoren. Lagrer Statamic brukerne sine i databasen (eloquent i config/statamic/users.php), må du sjekke først: Aurora gir users-tabellen UUID-nøkler. Med standardvalget, brukere i filer, kolliderer ingenting.

2. Spør KI-kodeagenten din

Boost har installert Auroras skills for Claude Code, Cursor og de andre kodeagentene. Be den i prosjektet:

Plain text

Port this Statamic site to Aurora CMS.

Skillen aurora-statamic tar det derfra, steg for steg, og spør der nettstedet trenger en avgjørelse fra deg:

Maler og oppsett blir Aurora-oppsett og blokkvisninger i Blade, fra Antlers eller Blade de var i.
Bard- og Replicator-sett blir blokker, én for hvert sett, og teksten mellom dem rik tekst-blokker.
Samlinger av sider blir sider med samme tre og adresser; en bloggs innlegg blir sider under bloggen; samlinger av poster, som et team, blir egne modeller for nettstedet med en skjerm i adminen og blokker som velger dem.
Globals blir en innstillingsfane, og navigasjon blir menyer.
Ressurser går inn i mediebiblioteket med alt-tekst og mapper, og skjemaer blir Aurora-skjemaer.
Et oppsett med flere nettsteder blir Auroras nettsteder og språk, med hver posts lokaliseringer som sidens oversettelser.

3. Sjekk det i den visuelle editoren

Innholdet kommer over med en artisan-kommando i nettstedet selv, som oppdaterer det den laget sist i stedet for å lage dubletter. Kjør den så ofte du trenger, åpne sidene under /admin og sammenlign dem med Statamic-nettstedet til de ser like ut.

4. Bytt over

Kjør importen en siste gang, etter redaktørenes siste endring i Statamic, og slå av Statamics ruter. Aurora viser nettstedet fra da av, og /cp virker fortsatt, til sammenligning.

config/statamic/routes.php PHP

'enabled' => false,

Sjekk de gamle adressene (en som er endret, får en videresending), skjemaene og menyene. Når ingen trenger Statamic lenger, fjerner du det med composer remove statamic/cms, sammen med filene: content/, resources/blueprints, resources/fieldsets, resources/forms, users/ og config/statamic/.

Uten en KI-agent

Stegene er de samme for hånd. Skillen, vendor/shipaurora/cms/resources/boost/skills/aurora-statamic/SKILL.md, har kartet fra hver del av Statamic til Aurora og kallene til Statamics API som leser den.

Les: lage blokker

Les: oppsett