@rocketoo/cli NPM

Rocketoo CLI

Oficiální CLI nástroj pro správu šablon Rocketoo e-shopů.

🚀 Instalace

NPM (doporučeno)

npm install -g @rocketoo/cli

Yarn

yarn global add @rocketoo/cli

Stažení binárního souboru

Stáhněte si zkompilovaný binární soubor z releases.

📋 Požadavky

Node.js 16.0.0 nebo vyšší
NPM nebo Yarn
Rocketoo e-shop s aktivním CLI modulem

🔐 Přihlášení

Před použitím se musíte přihlásit ke svému Rocketoo e-shopu:

rocketoo auth login

CLI se vás zeptá na:

URL vašeho e-shopu (např. https://vas-eshop.rocketoo.cz)
API klíč (získáte v administraci → Integrace → CLI)

🎨 Práce se šablonami

Nahrání šablony na server

# Základní nahrání
rocketoo theme push my-theme

# S popisem
rocketoo theme push my-theme --description "Nová verze šablony"

# Vynucené nahrání (přeskočí chyby validace)
rocketoo theme push my-theme --force

# Pouze validace bez nahrání
rocketoo theme push my-theme --validate-only

Aktivace šablony

# Aktivuje nejnovější verzi
rocketoo theme publish my-theme

# Aktivuje konkrétní verzi
rocketoo theme publish my-theme --version 1.2.0

# Bez potvrzovacího dotazu
rocketoo theme publish my-theme --yes

Seznam šablon

# Seznam vašich šablon
rocketoo theme list

# Zkrácený alias
rocketoo theme ls

Aktuální aktivní šablona

rocketoo theme current

Verze šablony

rocketoo theme versions my-theme

Validace šablony

# Validuje šablonu lokálně
rocketoo theme validate my-theme

⚙️ Konfigurace

Zobrazení konfigurace

# Celá konfigurace
rocketoo config get

# Konkrétní hodnota
rocketoo config get api_url

Nastavení hodnoty

rocketoo config set api_url https://novy-eshop.rocketoo.cz

Smazání hodnoty

rocketoo config delete api_key

📁 Struktura šablony

Šablona musí obsahovat následující strukturu:

my-theme/
├── theme.yaml          # Metadata šablony (povinné)
├── layouts/            # Layout soubory (povinné)
│   ├── default.htm
│   └── ...
├── pages/              # Stránky (povinné)
│   ├── home.htm
│   └── ...
├── partials/           # Částečné šablony (volitelné)
│   └── ...
├── assets/             # CSS, JS, obrázky (volitelné)
│   ├── css/
│   ├── js/
│   └── images/
└── lang/               # Jazykové soubory (volitelné)
    └── ...

theme.yaml

name: "Název šablony"
description: "Popis šablony"
author: "Autor"
version: "1.0.0"
homepage: "https://example.com"

🔒 Bezpečnost

CLI automaticky validuje šablony a kontroluje:

✅ Povolené přípony souborů: htm, html, css, js, json, yaml, yml, png, jpg, jpeg, gif, svg, webp, woff, woff2, ttf, eot, md, txt
❌ Nebezpečný obsah: PHP kód, eval(), system() funkce, atd.
📏 Velikost souborů: Max 5MB na soubor, 50MB celkem
📂 Struktura: Povinné adresáře layouts/ a pages/

🛠️ Pokročilé použití

Debug režim

rocketoo --debug theme push my-theme

Vlastní konfigurační soubor

rocketoo --config /path/to/config.json theme push my-theme

Bez barev

rocketoo --no-color theme list

🔍 Hledání šablon

CLI hledá šablony v tomto pořadí:

Přesná cesta (pokud obsahuje / nebo \)
Aktuální adresář
themes/ adresář v aktuálním adresáři

Příklady:

rocketoo theme push ./my-theme        # Relativní cesta
rocketoo theme push /path/to/theme    # Absolutní cesta  
rocketoo theme push my-theme          # Hledá v themes/my-theme