Advertising sustains the DA. Ads are hidden for members. Join today

On this page

11.6. Modul- és sminkfájlok kézi letöltése

Last updated on
14 April 2025

Célkitűzés

Ahogy a korábbi részeknél már említettük, néha előfordulhat olyan eset, amikor az automatizált eszközök, mint a Drush vagy a Composer nem használhatóak valamilyen oknál fogva (például amikor egyedileg fejlesztett modult vagy sminket telepítenénk a webhelyünkre).

Szükséges előismeretek

Webhely előfeltételei

Az itt leírt útmutatóra csak akkor van szükségünk, ha a korábbi részek során az alábbi akadályokba botlottunk a modulok vagy sminkek telepítése, frissítése során:

Ha a fenti esetek egyike sem áll fenn, akkor nyugodt szívvel átugorhatjuk ezt a szakaszt és folytathatjuk a következővel. Ha viszont használunk Composert a webhelyünkön, akkor az azt jelenti, hogy már automatizáltan kezeljük a szoftver (azaz a Drupal) forráskódjának fájlrendszerét, tehát nincs szükségünk az itt leírt lépéssor kézzel való elvégzésére. Ez esetben kövessük inkább a 3.5. szakasz - Rendszerfájlok letöltése és frissítése Composer használatával fejezet útmutatásait.

Lépések

Ez a leírás két esetet fed le:

  • Közösségi modul/smink feltelepítése: ekkor Letöltés és Feltöltés-kicsomagolás is történik.
  • Egyedi modul/smink feltelepítése: ekkor csak Feltöltés-kicsomagolás történik.

Utóbbi esetben tehát átugorhatjuk a következő, Letöltés részt (hiszen az egyedi modul/smink forráskódja már megvan, azt már nem szükséges beszereznünk).

Letöltés

  1. Nyissuk meg a modul vagy smink projektoldalát a Drupal.org webhelyen. Például az Admin toolbar modulé a https://www.drupal.org/project/admin_toolbar címen található.

  2. Görgessünk le a Downloads szakaszhoz egészen a lap alján:

    Közösségi modul forráskódjának letöltése

  3. Kattintsunk a tar.gz hivatkozásra, így böngészőnk lementi a tömörített fájlt a számítógépünkre. Ha a távoli kiszolgálónk Linuxon fut, és van parancssori hozzáférésünk, akkor egyszerűen futtathatjuk az alábbi parancsot, természetesen a webcímet lecserélve: 

    wget https://ftp.drupal.org/files/projects/admin_toolbar-8.x-1.26.tar.gz

Feltöltés és kicsomagolás

  1. A modulok és sminkek a webhelyünk gyökerének legfelső szintű /modules és /themes könyvtáraiban találhatóak. (Fontos! Nem a /core alattiakról van szó, azokhoz soha ne nyúljunk!) Az általánosan javasolt gyakorlat szerint ezeken belül is érdemes különválasztani őket forrásuk szerint közösségi (/contrib) és saját vagy egyedi (/custom) alkönyvtárakba. Ha ilyenek még nem léteznek a /modules és /themes könyvtárainkban, akkor érdemes most létrehoznunk őket. Ezután az alábbihoz hasonló képet kapunk:

    Javasolt könyvtárszerkezet a modulokhoz

  2. Ha egy már létező modult vagy sminket cserélünk le a frissebb verziójával, akkor érdemes az éles webhelyet ideiglenesen elzárni a látogatók elől: 11.2. szakasz - A webhely karbantartási módba kapcsolása.
  3. Ez azért javasolt, mert most töröljük a frissítendő modul/smink már létező könyvtárát. (Ha a látogató eközben épp olyan oldalt nyitna meg, amelyhez az ideiglenesen törölt modul/smink szükséges lenne, akkor hibát tapasztalna.)

  4. Töltsük fel a .tar.gz fájlt (lehet más kiterjesztése is a tömörített állománynak) a webhelyünk tárhelyére. A feltöltés célkönyvtárát válasszuk ki az alábbiak szerint:

    • Új modul/smink első telepítésekor a fentiekben létrehozott /contrib vagy /custom könyvtárak egyikét.
    • Már korábban létező modul/smink frissítésekor azt, ahonnan az imént letöröltük a régi verzióját.

  5. Csomagoljuk ki a .tar.gz (vagy más) tömörített állományt, ami így egy alkönyvtárat hoz létre a fájllal azonos szinten. Ha a távoli kiszolgálónk Linuxon fut, és van parancssori hozzáférésünk, akkor egyszerűen futtathatjuk az alábbi parancsot, természetesen a fájlnevet lecserélve: 

    tar -xzf admin_toolbar-8.x-1.17.tar.gz

Ha nem Linuxon fut a kiszolgáló, vagy nem használhatjuk a parancssort, akkor a tárhelyszolgáltatónk valószínűleg kínál valamilyen grafikus felületet a kicsomagolás elvégzésére.

  1. Ha a kicsomagolási művelet nem tette meg magától, akkor töröljük a tömörített állományt kézzel.

  2. Innentől már visszatérhetünk a korábbi témakörökhöz, ahol elakadtunk, hogy befejezzük a lépéssorokat:

Az ismeretek elmélyítése

  • Ha egy webhelynek több példányát tartjuk fenn (például egy helyi fejlesztői környezetet is az éles webhelyen kívül), akkor ezt a folyamatot mindegyiken el kell végeznünk, vagy újra kell klónoznunk az egyiket a már frissített másikból. Minderről bővebben lásd a 11.8. szakasz - Fejlesztési célú webhelypéldány létrehozása szakaszt.
  • Ha új sminket telepítettünk, és a régire már nincs szükségünk, akkor javasolt azt eltávolítani a Kezelés adminisztrációs menüben a Megjelenés oldalon (vagy a címsorban adjuk meg az admin/appearance útvonalat).

Videó

Modul- és sminkfájlok kézi letöltése

Egyéb források

Az alább felsorolt közösségi dokumentációk a Drupal.org-on bár angol nyelvűek, de hasznosak lehetnek a téma alaposabb megértéséhez:

Közreműködők

Írta és szerkesztette: Boris Doesborg, Jennifer Hodgdon és Marc Isaacson. Fordította: Balu Ertl (Brainsum).

 

This page is generated from AsciiDoc source from the User Guide. To propose a change, edit the source and attach the file to a new issue in the User Guide project. PDF and e-book formats are available on the User Guide project page.

Source file: extend-manual-install.asciidoc

Help improve this page

Page status: No known problems

You can: