Acorn: Laravel-komponensek a WordPressben
Az Acorn Laravel-komponenseket visz a WordPress témákba és bővítményekbe: Blade-nézetek, view composerek és a wp acorn parancsok.
Az Acorn a Roots csapat csomagja, amellyel Laravel-komponenseket használhatsz egy WordPress témában vagy bővítményben. Betölt egy Laravel alkalmazás-konténert a WordPress életciklusa mellé, és közben megtartja a WordPress sablonhierarchiáját. A Sage téma erre épül.
Mit kapsz tőle
Szekció neve “Mit kapsz tőle”- Blade-sablonok a PHP-sablonok helyett.
- Artisan-szerű parancsok a
wp acornalatt. - View composerek: adatot kötsz egy nézethez, és a sablon tiszta marad.
- Laravel-stílusú konfiguráció a
config/mappában. - Service providerek a saját szolgáltatásaidhoz.
- Opcionálisan útvonalak, kontrollerek, Eloquent-modellek, naplózás és gyorsítótár.
Követelmények
Szekció neve “Követelmények”Az Acorn igénye a WordPressből és a Laravelből jön: egy mai PHP a szokásos bővítményekkel, a WordPress, és a WP-CLI. A pontos minimumot az Acorn telepítési oldala mindig a legfrissebb kiadáshoz írja. A PHP-verzió legyen ugyanaz a fejlesztői gépen és élesben, különben a Composer-függőségek hibát dobhatnak.
Telepítés
Szekció neve “Telepítés”Az Acorn Composerrel települ. Sage témánál ez már megtörtént, ott nincs további teendőd.
composer require roots/acornSaját témában vagy bővítményben be is kell töltened. A téma functions.php fájljába (vagy a bővítmény főfájljába) ez kerül:
<?php
use Roots\Acorn\Application;
if (! class_exists(\Roots\Acorn\Application::class)) { wp_die( __('You need to install Acorn to use this site.', 'domain'), '', [ 'link_url' => 'https://roots.io/acorn/docs/installation/', 'link_text' => __('Acorn Docs: Installation', 'domain'), ] );}
add_action('after_setup_theme', function () { Application::configure() ->withProviders([ App\Providers\ThemeServiceProvider::class, ]) ->boot();}, 0);Az Application::configure() után láncolva további beállítások is jöhetnek (withMiddleware, withExceptions, withRouting). Ezekhez az Acorn dokumentációja ad példát.
Ezután add hozzá a composer.json post-autoload-dump eseményéhez az Acorn szkriptjét. A legegyszerűbb, ha a parancs elvégzi helyetted:
wp acorn acorn:installHa rákérdez, válaszolj igennel az autoload dump szkriptre. A wp acorn parancsok csak akkor működnek, ha az Acornt betöltő téma vagy bővítmény aktív. Különben ezt a hibát kapod: Error: 'acorn' is not a registered wp command.
Könyvtárszerkezet
Szekció neve “Könyvtárszerkezet”Az Acorn konfiguráció nélkül is elindul: a saját alapbeállításait használja, a gyorsítótárat és a naplókat pedig a WordPress cache-mappájába teszi (wp-content/cache/acorn/, Bedrocknál web/app/cache/acorn/).
Ha Laravel-szerűbb szerkezetet szeretnél, az Acorn létre tudja hozni:
wp acorn acorn:init storage && wp acorn vendor:publish --tag=acornEz egy storage/ mappát és egy config/ mappát ad a téma gyökerében. A config/ mappából a hiányzó fájlokat (például az app.php-t) az Acorn a saját alapértelmezettjéből pótolja.
Bedrocknál a projekt gyökerében az Acorn config/ mappája ütközik a Bedrock sajátjával. Ezért az Acornt a témából telepítsd, ne a projekt gyökeréből.
Blade-nézetek és composerek
Szekció neve “Blade-nézetek és composerek”A nézetek a resources/views/ mappában vannak, .blade.php kiterjesztéssel. A Blade szintaxisát a Laravel dokumentációja írja le, az Acornban szinte minden működik belőle.
A WordPress-ciklus Bladeben:
@while (have_posts()) @php(the_post())
<article @php(post_class())> <h2>{{ get_the_title() }}</h2> {!! get_the_content() !!} </article>@endwhileAz adatot ne a nézetben állítsd össze, hanem composerben. A composer egy PHP-osztály, amely adatot köt egy vagy több nézethez. Létrehozni WP-CLI-vel a legegyszerűbb:
wp acorn make:composer PageHeader<?php
namespace App\View\Composers;
use Roots\Acorn\View\Composer;
class PageHeader extends Composer{ protected static $views = [ 'partials.page-header', ];
public function with() { return [ 'title' => get_the_title(), ]; }}A $title változó ezután csak a partials.page-header nézetben (és az általa beágyazott nézetekben) érhető el. Ha a composer neve és helye megegyezik a nézetével (resources/views/partials/page-header.blade.php és app/View/Composers/PageHeader.php), a $views tömböt el is hagyhatod: a Sage automatikusan összepárosítja őket.
Hasznos parancsok
Szekció neve “Hasznos parancsok”wp acorn list # az elérhető parancsokwp acorn about # az alkalmazás alapadataiwp acorn make:composer Név # új view composerwp acorn make:component Név # új nézetkomponenswp acorn make:provider Név # új service providerwp acorn view:cache # a Blade-nézetek előfordításawp acorn view:clear # a lefordított nézetek törlésewp acorn optimize # konfiguráció és nézetek gyorsítótárazásawp acorn optimize:clear # a gyorsítótárak törléseÉlesítéskor futtasd a wp acorn optimize parancsot. Ha a kód frissítése után régi nézetet látsz, a wp acorn optimize:clear törli a gyorsítótárat.
Ha egy bővítmény ütközik az Acornnal
Szekció neve “Ha egy bővítmény ütközik az Acornnal”Az Acorn sok Composer-függőséget hoz. Ha egy WordPress-bővítmény ugyanennek egy régebbi változatát csomagolja a saját névtere nélkül, az ütközést okozhat. A hiba a bővítmény oldalán van: a készítőnek kellene a függőségeit saját névtérbe csomagolnia (PHP-Scoper, Imposter, Mozart). Az Acorn dokumentációjának Compatibility oldala listázza az ismert eseteket, és ahol van, javítócsomagot (Composer patch) is ajánl.
Hasznos linkek
Szekció neve “Hasznos linkek”Készült: Frissítve: