Gravity-bővítmények telepítése Composerrel

A Gravity Formst, a Gravity SMTP-t és a hozzájuk tartozó kiegészítőket Composerrel is telepítheted és frissítheted. A Composer ingyenes PHP-s függőségkezelő, amellyel megadod a szükséges csomagokat, és a parancssorból kezeli őket. Ez a lehetőség csak aktív Elite (és régi Developer) licenc mellett érhető el, és csak azokat a kiegészítőket telepítheted, amelyekre a licenced jogosít.

Kinek való

A Composer fejlesztői eszköz. Ha nem vagy fejlesztő, használd inkább a WordPress beépített bővítménykezelőjét az automatikus frissítésekkel, amelyekhez a Gravity Forms készült.

Előfeltételek

• PHP 8 vagy újabb.
• Telepített Composer 2 vagy újabb (ellenőrzés: composer --version).
• Parancssori környezet a parancsok futtatásához.
• Olvasási és írási jog a WordPress mappáihoz.

Telepítés a Composer parancssorával

1. Győződj meg róla, hogy van composer.json a WordPress-projektedben. Ez mondja meg a Composernek, milyen csomagok kellenek és hová kerüljenek. Ha még nincs, futtasd a composer init parancsot, és kövesd a kérdéseket.

2. Állítsd be a hitelesítést a következő paranccsal. Globális beállításhoz add hozzá a --g kapcsolót.

   composer config http-basic.composer.gravity.io LICENCKULCS https://OLDAL_CIME

   A LICENCKULCS helyére a bővítmény licenckulcsa kerül, az OLDAL_CIME helyére az az oldalcím, amelyet aktiválni szeretnél.

3. Add hozzá a Gravity Composer-csomagtárat. Ha a Composer rákérdez a composer/installers engedélyezésére, írd be, hogy yes, és nyomj Entert.

   composer config repositories.gravity '{"type": "composer", "url": "https://composer.gravity.io"}'

4. Telepítsd a szükséges bővítményeket vagy kiegészítőket. A csomag neve gravity/<slug>: a Gravity Formsé gravity/gravityforms, a Gravity SMTP-é gravity/gravitysmtp.

   composer require gravity/gravityforms gravity/gravitysmtp

Kézi telepítés Composerrel

Ha a parancssoros módszer valamiért nem működik, kézzel is beállíthatod.

1. Legyen composer.json a WordPress-projekt gyökerében. Ha nincs, hozd létre:

   {
       "name": "org/package",
       "authors": [
           {
               "name": "Neved",
               "email": "[email protected]"
           }
       ],
       "require": {}
   }

2. A hitelesítéshez hozz létre egy auth.json fájlt a projekt gyökerében:

   {
       "http-basic": {
           "composer.gravity.io": {
               "username": "A_LICENCKULCSOD",
               "password": "https://AZ_OLDALAD_CIME"
           }
       }
   }

3. Add hozzá a csomagtárat a composer.json fájlhoz:

   {
       "name": "org/package",
       "require": {},
       "repositories": {
           "gravity": {
               "type": "composer",
               "url": "https://composer.gravity.io"
           }
       }
   }

4. A telepítendő bővítményeket írd a require részbe:

   "require": {
       "gravity/gravityforms": "*",
       "gravity/gravitysmtp": "*"
   }

5. Futtasd a composer install parancsot.

Verziók kezelése

A verziómegadás szabályait a Composer saját útmutatója írja le. A Gravity-csomagokra ugyanúgy vonatkoznak.

Egyes bővítmények kezelése

A composer require paranccsal új bővítményt telepíthetsz, vagy frissítheted a meglévőt.

Egy kiegészítő telepítése vagy frissítése a legújabb verzióra ({slug} a kiegészítő azonosítója):

composer require gravity/{slug}

Adott verzió telepítése ({version} a verziószám):

composer require gravity/{slug}:{version}

Példák:

Parancs	Eredmény
composer require gravity/gravityforms	A Gravity Forms legújabb verziója kerül a composer.json szerinti helyre.
composer require gravity/gravityforms:2.9.5	A 2.9.5-ös verzió települ.
composer require gravity/gravityforms:2.9	A legújabb 2.9-cel kezdődő verzió települ (mintaillesztés: 2.9.*).
composer require gravity/gravityforms:2.9.0	Pontosan a 2.9.0 verzió települ.

A telepítési útvonal módosítása

A Gravity csomagjai wordpress-plugin típusúak, és alapból a wp-content/plugins mappába települnek. Ha más útvonalat szeretnél, add hozzá a composer.json fájlhoz az extra részt, és állítsd a kívánt, a composer.json-hoz viszonyított útvonalra:

{
    "name": "org/package",
    "require": {},
    "repositories": {
        "gravity": {
            "type": "composer",
            "url": "https://composer.gravity.io"
        }
    },
    "extra": {
        "installer-paths": {
            "wp-content/plugins/{$name}": ["type:wordpress-plugin"]
        }
    }
}

A kiegészítők általános telepítéséről a Kiegészítők telepítése fejezetben olvashatsz.