Tovább a tartalomhoz

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.

  • Blade-sablonok a PHP-sablonok helyett.
  • Artisan-szerű parancsok a wp acorn alatt.
  • 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.

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.

Az Acorn Composerrel települ. Sage témánál ez már megtörtént, ott nincs további teendőd.

Terminál
composer require roots/acorn

Sajá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:

functions.php
<?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:

Terminál
wp acorn acorn:install

Ha 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.

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:

Terminál
wp acorn acorn:init storage && wp acorn vendor:publish --tag=acorn

Ez 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.

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:

resources/views/index.blade.php
@while (have_posts())
@php(the_post())
<article @php(post_class())>
<h2>{{ get_the_title() }}</h2>
{!! get_the_content() !!}
</article>
@endwhile

Az 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:

Terminál
wp acorn make:composer PageHeader
app/View/Composers/PageHeader.php
<?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.

Terminál
wp acorn list # az elérhető parancsok
wp acorn about # az alkalmazás alapadatai
wp acorn make:composer Név # új view composer
wp acorn make:component Név # új nézetkomponens
wp acorn make:provider Név # új service provider
wp acorn view:cache # a Blade-nézetek előfordítása
wp acorn view:clear # a lefordított nézetek törlése
wp acorn optimize # konfiguráció és nézetek gyorsítótárazása
wp 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.

Készült: Frissítve:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások