# Y-Square Geschenk Gutscheine

## Installation über Satis (empfohlen)

Das Paket wird über den Y-Square Satis-Server unter `https://packages.y-square.de` bereitgestellt. Damit lassen sich Installation und Updates komplett über Composer abwickeln, ohne dass Zip-Dateien manuell entpackt werden müssen.

1. Das Y-Square Repository einmalig in der `composer.json` des Shops hinterlegen:
   ```
   composer config repositories.ysquare composer https://packages.y-square.de
   ```
2. Das Modul installieren:
   ```
   composer require --update-no-dev ysquare/ys_giftcert
   ```
3. Modul im OXID eShop Admin aktivieren
4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren

### Update

```
composer update --no-dev ysquare/ys_giftcert
```

Nach dem Update das Modul im Admin kurz deaktivieren und wieder aktivieren, Tmp-Verzeichnis leeren und Views neu generieren.

## Installation über lokales Paket (Fallback)

Falls keine Verbindung zum Satis-Server möglich ist (z.B. lokale Entwicklung mit Vorab-Version), kann das Paket auch direkt aus einem Verzeichnis installiert werden:

1. Verzeichnispfad `packages/ysquare` auf derselben Ebene wie `source` und `vendor` anlegen
2. Unterordner `ys_giftcert` anlegen und die Zip-Datei dort entpacken
3. Aus dem Hauptverzeichnis des Shops ausführen:
   ```
   composer config repositories.ysquare '{"type":"path", "url": "./packages/ysquare/*"}'
   composer require --update-no-dev ysquare/ys_giftcert
   ```
4. Modul im OXID eShop Admin aktivieren
5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren

### Update (lokales Paket)

1. Neue Modulversion in den Ordner `packages/ysquare/ys_giftcert` entpacken
2. Modul im OXID eShop Admin deaktivieren
3. Aus dem Hauptverzeichnis des Shops ausführen:
   ```
   composer update --no-dev ysquare/ys_giftcert
   ```
   Die Frage, ob die Dateien des Pakets überschrieben werden sollen, mit "Y" bestätigen.
4. Modul im OXID eShop Admin aktivieren
5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren


## ToDo:
- Block in die page/checkout/payment.tpl einfügen (Checkbox ob der User sein Guthaben einlösen möchte):

```
[{block name="ys_giftcert_checkout_use_pool_money"}]
[{/block}]
```

- In page/account/inc/account_menu.tpl an die gewünschte Stelle einfügen:

```
<li class="list-group-item[{if $active_link == "ys_giftcert"}] active[{/if}]">
    <a class="list-group-link" href="[{oxgetseourl ident=$oViewConf->getSslSelfLink()|cat:"cl=account_ysgiftcert"}]" title="[{oxmultilang ident="YS_ACCOUNT_MENU_GIFTCERT"}]">[{oxmultilang ident="YS_ACCOUNT_MENU_GIFTCERT"}]</a>
</li>
```