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

> Hogyan telepítheted és frissítheted a Gravity Formst, a Gravity SMTP-t és a kiegészítőket Composerrel: hitelesítés, tároló, verziók és telepítési útvonal.

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.

   ```bash
   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.

   ```bash
   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`.

   ```bash
   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:

   ```json
   {
       "name": "org/package",
       "authors": [
           {
               "name": "Neved",
               "email": "te@example.com"
           }
       ],
       "require": {}
   }
   ```

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

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

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

   ```json
   {
       "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:

   ```json
   "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):

```bash
composer require gravity/{slug}
```

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

```bash
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:

```json
{
    "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](https://hub.hellowp.io/hu/plugins/gravityforms/kiegeszitok-telepites/) fejezetben olvashatsz.