6.1 Něco málo o contrib modulech


Zde se nachází původní verze stránek, věnovaná verzi Drupal 8 (konkrétně 8.8).

Tento návod by v září 2020 nahrazen aktualizovanou a rozšířenou verzí pro Drupal 9.

 

Core moduly jsme si probrali již dříve, teď se podíváme, jak používat contrib moduly.

Hledání modulu

Jak bylo dříve řečeno, contrib modulů existují tisíce, a prakticky každý den nové přibývají, takže je z čeho vybírat. Většinou tedy už existuje modul, který řeší náš problém. Dejme tomu, že hledáme modul, který umožní vložení YouTube videa. A nechceme ho vkládat přímo do editoru, ale vložit YouTube link jako hodnotu políčka a pak mít možnosti ho nějak formátovat.

Každý modul má svoje strojové jméno, pod kterým je ke stažení ze stránek Drupalu, např. modul Admin Toolbar má strojové jméno admin_toolbar, a tedy URL https://www.drupal.org/project/admin_toolbar.

Hledání pomocí internetového vyhledávače (např. Google)

Jednoduché, dáme hledat „Drupal 8 Youtube field“ a dostaneme hromadu výsledků. Otevřeme se první tři, ty vypadají zajímavě - už podle URL (https://www.drupal.org › project ) je vidět, že jsou to stránky modulů. 

  • YouTube Field - hned první výsledek se ukáže být tím správným
  • YouTube: Field - dle stránky je vidět, že to byl spíš jen nějaký neuskutečněný pokus o modul
  • Video Embed Field - dělá trochu něco jiného (vkládá video do editoru), a pro nás zbytečně podporuje i další video služby
Hledání pomocí internetového vyhledávače

 

Hledání na stránce modulů

Na stránce s moduly https://www.drupal.org/project/project_module zkusím hledat: pro Drupal verze 8.x, klíčová slova „youtube field“ a řadit dle „Relevancy“.

Hned první výsledek je opět „YouTube Field“ modul. Další nadějný modul „Youtube Formatter“ existuje pouze pro Drupal 7, verze pro Drupal 8 nebyla nikdy dokončená (ale existuje v seznamu „View all releases“). 

Hledání na stránce modulů

Hledání v abecedním seznamu modulů podle klíčového slova

Lze hledat i v úplném abecední seznamu všech modulů https://www.drupal.org/project/project_module/index/sandbox?project-status=full&drupal_core=7234. Hledání slova „youtube“ vrátí 17 výsledků, z nichž je opět nejnadějnější modul „YouTube Field“.

Hledání v abecedním seznamu modulů podle klíčového slova

Výběr správné verze modulu

Moduly často mývají stabilní nebo vývojové (development) verze. Kterou nainstalovat bývá často zajímavá otázka. Doporučoval bych asi následující pořadí:

  • Existuje stabilní release? Tak určitě začít s ním.
  • Chybí mi nějaká nová, potřebná funkcionalita, kterou obsahuje development verze? Pak je čas sáhnou právě pro ni. Stejně tak, pokud stabilní verze obsahuje nějakou chybu, která mě limituje, a je opravená v development verzi.
  • Ani poslední development verze nefunguje podle očekávání? Možná obsahuje chybu, která je už známá a opravená. Pak je třeba si projít seznam issue a zkusit najít odpověď tam. 

Barva pozadí rámečku označují verzi doporučenou (zelená), nebo ostatní (krémová). Pokud rámeček obsahuje „štít“, znamená to status „Stable release covered by the Drupal Security Team“, více viz.  https://www.drupal.org/drupal-security-team

Výběr správné verze modulu

Řešení závislostí mezi moduly

Některé moduly (např. Pathauto) nelze povolit, dokud se nevyřeší jejich závislost na jiném modulu. Bohužel webové rozhraní to neumí řešit automaticky, to funguje pomocí nástrojů pro příkazovou řádku.

Řešení závislostí mezi moduly

Sub-moduly

Některé moduly - např. Admin Toolbar - obsahují samotný modul plus sub-moduly doplňující nebo rozšiřující základní modul. Zde konkrétně hlavní Admin Toolbar, a sub-moduly Admin Toolbar Extra Tools a Admin Toolbar Links Access Filter.

Sub-moduly