Konfigurera Bedrock

Bedrock är en WordPress-boilerplate med en mer modern mappstruktur som kan göra livet enklare för utvecklare.

Du kan följa denna guide för att konfigurera Bedrock på Templ.

Installera Bedrock på Templ

Först behöver du antingen ladda upp din befintliga Bedrock-sajt till Templ eller skapa ett nytt Bedrock-projekt.

För att skapa ett nytt Bedrock-projekt med composer, anslut till din sajt via SSH och kör:

composer create-project roots/bedrock

Placera ditt Bedrock-projekt utanför webbrotkatalogen (app_xxxx) - till exempel direkt i din hemkatalog, /home/user_xxxx/bedrock. Webbroten kommer själv att ersättas med en symbolisk länk i nästa steg.

"Ändra" webbrotkatalog

Webbrotkatalogen på Templ är fixerad som /home/user_xxxx/app_xxxx.

För att kunna servera vår Bedrock-sajt, som är placerad utanför webbrotkatalogen, kan vi ersätta webbrotkatalogen med en symbolisk länk som pekar på Bedrock.

Ta bort din nuvarande webbrotkatalog tillsammans med dess innehåll:

rm -rf app_xxxx

Sedan behöver vi skapa en relativ symbolisk länk som pekar webbrotkatalogen mot mappen inuti Bedrock där index.php och wp-config.php finns, t.ex.:

ln -s bedrock/web/ app_xxxx

För att denna ändring ska träda i kraft måste du också starta om din hemsida i Templ-panelen.

Vår backup-funktion kommer endast att säkerhetskopiera innehåll i app_xxxx. Om du har t.ex. din uploads-mapp utanför rotkatalogen (pekat på med en symbolisk länk), vänligen meddela oss så att vi kan säkerställa att den mappen säkerhetskopieras.

Uppdatera inloggningsuppgifter i .env

Sist behöver du också uppdatera inloggningsuppgifterna inuti .env-filen som finns i Bedrock-mappen.

Du behöver vanligtvis uppdatera åtminstone följande uppgifter:

DB_NAME
DB_USER
DB_PASSWORD
WP_HOME

Du kan hitta din sajts databasinloggningsuppgifter samt dess domännamn i Templ-panelen.

Du bör också se till att ersätta salts för bättre säkerhet.

Begränsningar

Ett Bedrock-projekt håller de flesta av sina filer, inklusive .env och config/, utanför webbroten (app_xxxx). Templs staging-, backup- och domänfunktioner berör endast webbroten och databasen, så var och en kräver manuella steg från dig.

Domänändringar

Att ändra en hemsidas domän i Templ-panelen kör en sök-ersätt i databasen, men Bedrock definierar sin sajt-URL som konstanter från WP_HOME och WP_SITEURL i .env, och dessa konstanter vinner över databasvärdena. Sajten fortsätter att använda den gamla domänen tills du redigerar .env själv.

Efter att ha ändrat domänen i panelen, anslut via SSH, ställ in WP_HOME (och WP_SITEURL om du ställer in den explicit) till den nya domänen, och starta om hemsidan.

Staging-hemsidor

Staging kopierar webbroten och databasen i båda riktningarna - att skapa en staging-sajt och att kopiera staging till production. Allt utanför webbroten, inklusive composer.json, config/ och vendor/, lämnas kvar, så en nyss skapad staging-sajt har inget Bedrock-projekt att servera.

För att slutföra konfigurationen själv, anslut via SSH och:

Kopiera bedrock/-mappen från production till staging-sajtens hemkatalog.
Återskapa den symboliska länken på staging: ln -s bedrock/web/ app_xxxx.
Uppdatera .env på staging med staging-sajtens databasinloggningsuppgifter och WP_HOME.
Starta om staging-hemsidan.

Fortsätt att distribuera ändringar utanför webbroten med git eller SSH i båda riktningarna, eftersom kopiering av staging till production inte kommer att flytta dem heller.

Om du hellre inte vill göra detta själv, kontakta support så kommer vi att konfigurera det åt dig.

Återställning av backup

Backuper täcker webbroten och databasen, så att återställa en backup återställer bedrock/web/-innehåll såsom app/uploads plus din databas. Filer utanför webbroten - composer.json, config/, vendor/ och .env - säkerhetskopieras inte och kommer inte att återställas. Håll dem under versionshantering och omdistribuera dem med git och composer install.

Efter en återställning, verifiera att app_xxxx fortfarande är en symbolisk länk som pekar på bedrock/web/ och återskapa den om den inte är det.