Mobile Phone: +48 785 868 901

Location: GPS 12.1 13.4

 12:42

 dariusz.garus@gmail.com

 https://dariuszgarus.pl

 Robotnicza 23/23, 42-230 Koniecpol

 22 czerwiec 1974

 12:30

Przewodnik po zarządzaniu zasobami w Concrete CMS

Witaj w przewodniku, który pomoże Ci zrozumieć, jak zarządzać zasobami (CSS, JavaScript) w Concrete CMS. Nawet jeśli dopiero zaczynasz swoją przygodę z programowaniem, ten przewodnik przeprowadzi Cię krok po kroku przez najważniejsze aspekty zarządzania zasobami w tym systemie.

Co to są zasoby (Assets)?

Zasoby to pliki CSS i JavaScript, które są kluczowe dla działania Twojej strony. Na przykład, aby Redactor (edytor tekstowy) działał poprawnie, musisz załadować odpowiednie pliki JavaScript i CSS, takie jak:

• concrete/js/redactor.js
• concrete/css/redactor.css
• concrete/js/file-manager.js
• concrete/css/file-manager.js

Wcześniej do dodawania zasobów używano metod takich jak $view->addHeaderItem() czy $view->addFooterItem(). Chociaż nadal są dostępne, lepszym rozwiązaniem jest używanie bardziej elastycznego systemu zarządzania zasobami.

Framework Zasobów

Framework Zasobów w Concrete CMS, znajdujący się w przestrzeni nazw \Concrete\Core\Asset, umożliwia rejestrowanie zasobów, obsługę minifikacji, wersjonowania i ścieżek do plików. Możesz także grupować zasoby, co ułatwia ich dołączanie. Na przykład, aby dodać zasoby dla Redactora, wystarczy użyć:

$this->requireAsset('redactor');

Zasoby w szablonach

Szablony w Concrete CMS mogą zawierać własne zasoby. Przykładowo, szablon Bootstrap 3 zawiera style CSS i skrypty JavaScript związane z Bootstrapem. Aby uniknąć konfliktów i duplikacji zasobów, dodajemy następujący kod do klasy PageTheme:

public function registerAssets()
{
    $this->providesAsset('javascript', 'bootstrap/*');
    $this->providesAsset('css', 'bootstrap/*');
    $this->providesAsset('css', 'blocks/form');
    $this->providesAsset('css', 'core/frontend/*');
    $this->requireAsset('javascript', 'jquery');
}

Rejestrowanie zasobów w Concrete CMS

Aby używać zasobu w Concrete CMS, musisz go zarejestrować. Oto przykład rejestrowania jQuery:

$al = \Concrete\Core\Asset\AssetList::getInstance();
$al->register('javascript', 'jquery', 'js/jquery.js');

• getInstance(): Pobiera instancję klasy AssetList.
• register(): Rejestruje zasób z typem (np. 'javascript' lub 'css'), unikalnym identyfikatorem (np. 'jquery'), ścieżką do pliku oraz opcjonalnymi parametrami.

Typy zasobów w Concrete CMS

Obsługiwane typy zasobów to:

• css: Arkusze stylów CSS.
• css-inline: Wbudowane elementy stylów.
• javascript: Pliki JavaScript.
• javascript-inline: Wbudowane skrypty JavaScript.

Specyfikacja ścieżek

Ścieżki do plików w metodzie register() są względne i mogą odnosić się do katalogów application/, packages/package_handle/ lub concrete/.

Rejestrowanie zasobów w różnych kontekstach

• W plikach startowych: Możesz rejestrować zasoby w pliku application/bootstrap/app.php, metodzie on_start() pakietu lub bloku.
• W blokach: Dodaj rejestrację zasobu w metodzie on_start() typu bloku.
• W pakietach: Rejestracja zasobów powinna odbywać się w kontrolerze pakietu, w metodzie on_start().

Opcje rejestracji

Możesz dodać dodatkowe opcje podczas rejestrowania zasobu, np. określenie pozycji (HEADER lub FOOTER), wersji, czy zasób ma być minifikowany lub łączony. Przykład:

$al->register(
    'javascript', 'mediaelement', 'blocks/audio/mediaelement/mediaelement-and-player.min.js',
    array('version' => '2.16.3', 'minify' => false, 'combine' => true)
);
$al->register(
    'css', 'mediaelement', 'blocks/audio/mediaelement/mediaelementplayer.min.css',
    array('version' => '2.16.3', 'minify' => false, 'combine' => true)
);

Grupy zasobów

Możesz grupować zasoby, aby łatwiej nimi zarządzać. Przykład:

$al = \Concrete\Core\Asset\AssetList::getInstance();
$al->registerGroup('mediaelement', array(
    array('css', 'mediaelement'),
    array('javascript', 'jquery'),
    array('javascript', 'mediaelement')
));

Wymaganie zasobów

Aby dodać zasób lub grupę zasobów na stronie lub w bloku, użyj requireAsset(). Przykłady:

• W kontrolerach stron:

public function view() {
    $this->requireAsset('mediaelement');
}

• W kontrolerach bloków:

public function add() {
    $this->requireAsset('core/filemanager');
}

public function registerViewAssets($outputContent = '') {
    $this->requireAsset('mediaelement');
}

Podsumowanie

Zarządzanie zasobami w Concrete CMS może wydawać się skomplikowane, ale z odpowiednim podejściem staje się proste i efektywne. Rejestracja zasobów, ich grupowanie i dodawanie do stron oraz bloków pozwala na tworzenie nowoczesnych, funkcjonalnych witryn internetowych bez zbędnych komplikacji.