Drupal modul fejlesztés a Drupal.org-on

Miért fejleszt az ember a Drupal.org-ra egy saját modult?

Akkor készítünk contrib modult. ha van egy olyan ötletünk, amit sokan tudnának használni és még nincsen meg a funkció modulként a Drupal.org-on vagy máshol a világon. Ha azt akarom, hogy a modulomat a világon sokan használják, akkor a fejlesztett modult a Drupal.org-ra teszem fel. A Drupal.org-on van egy minőségbiztosítási felület is, ezért is érdemes odatenni a modult.

Kezdés

  • Kell egy account a Drupal.org-ra: Itt lehet készíteni
  • Meg kell ismerkedni a GIT verziókezelő rendszerrel, mert a drupal.org azt használja.
    • Telepíteni kell a GIT-et a saját gépre.
    • Néhány alap parancsot el kell sajátítani
  • A Drupal.org-on létre kell hozni egy új projektet: Belépés => My Dashboard => Your Projects => Add new project
  • Készíteni kell egy Module projectet (vagy akármi mást)
    • Ki kell választani a nevét
    • A rövid nevét
    • A típusát (Full project vagy Sandbox project) - A Sandbox projektet nem lehet publikálni, a Full projektet mindenki eléri.
    • A kezelési gyakoriságát (Maintenance Status - Aktív, minimálisan karbantartott, társak keresése, új karbantartó keresése, nem támogatott)
    • A fejlesztés állapota (aktívan fejlesztett, hibajavítások csak, nincsenek további fejlesztési tervek, nem továbbfejlesztendő)
    • a modul kategóriáját.
    • A modul leírását el kell készíteni szövegesen, erre nem térek ki. A mentés után létrejön a leírás

A Drupal org-on a projekt létrejötte után az alábbi parancsokat kell használni a GIT-en

mkdir project_rovid_nev
cd project_rovid_nev
git init
git add *
git checkout -b @branch
echo "Projekt neve" > README.txt
git add README.txt
git commit -m "Initial commit."
git add *
git remote add origin git@git.drupal.org:project/fz_songbook.git
git push origin @branch

Ha tag-et (=végleges verziót) akarunk készíteni a Drupal.org-on, akkor

git tag 7.x-1.0   //vagy valami más verziószám...
git push --tags

Ha csak egy tag-et akarunk feltölteni, akkor

git push origin tag 7.x-1.0

Ha csak ellenőrizni akarjuk a tag-eket, akkor

git tag -l

Branchokkal (development verzió = fejlesztési verzió) való munka

Készítsünk új fejlesztési verziót

git checkout -b 7.x-2.x

Ha készítettünk egy fejlesztési verziót, azt töltsük fel a remote adatbázisba

git push origin 7.x-2.x

az aktuális brancj kikérése

git checkout 7.x-2.x

A létező branch-ok listája

git branch -v

Az -u hatására a helyi aktuális kód lesz a remote aktuális

git checkout -b 7.x-1.x
git push -u origin 7.x-1.x

Branch / tag törlése

Ha tag-et akarunk törölni. A második parancs akkor kell, ha a remote szerveren fel van töltve a branch

git branch -d brach_neve
git push origin :branch_neve

Ha tag-et akarunk törölni. A második parancs akkor kell, ha a remote szerveren fel van töltve a tag

git tag -d tag_neve
git push origin :tag_neve