🚀 CMSLite - Jednoduchý PHP/SQL Redakční systém

Jednoduchý CMS určený pro rychlé nasazení a správu článků a uživatelů.
CMSLite podporuje vícejazyčnost (CZ/EN), role uživatelů, moderní WYSIWYG editor (CKEditor5), SEO-friendly URL a základní REST API s JSON a XML výstupy.

---

🔑 Hlavní funkce

• Role uživatelů: main-admin (nejvyšší práva), admin, redaktor.
• Administrace článků: Vytváření, editace, mazání článků s přehledným rozhraním.
• Editor CKEditor5: Moderní WYSIWYG editor s podporou tabulek, obrázků a formátování.
• Správa médií: Automatické ukládání obrázků podle slugu článku (uploads/slug-clanku/).
• SEO-friendly URL & Tagy: Automatické generování slug a správa tagů.
• Vícejazyčnost: CZ/EN s možností rozšíření dalších jazyků.
• REST API: Základní JSON a XML endpointy pro články a uživatele.
• Bezpečnost: Ověřování administrátora, omezení API podle povolených domén.

---

🛠️ Instalace a konfigurace

Instalace (Github - .ZIP)

• Stáhnout ZIP s CMSLite z github
• Rozbalit ZIP do hlavní složky
• Kontrola názvu složky s cms: CMSLite

1. Požadavky

• PHP 8+
• Web server s povolením zápisu do /uploads/

2. Nastavení práv

Složka /uploads/ musí mít zápis z web serveru (0777 nebo 777).

3. Konfigurace .env

Příklad .env souboru:

# Hlavní admin
ADMIN_USERNAME="vase_jmeno"
ADMIN_PASSWORD="vase_hash_hesla"

🔥 UPOZORNĚNÍ: Před spuštěním změň výchozí hodnoty. Bez toho je účet administrátora nebezpečný.

URL důležitých částí CMSLite

• https://vas-web.cz/CMSLite/admin/ - admin rozhraní
• https://vas-web.cz/CMSLite/api/ - api složka - dělí se na /json/ a /xml/ viz. REST API – CMSLite
• https://vas-web.cz/CMSLite/uploads/ - složka s náhledy článků
• https://vas-web.cz/CMSLite/uploads/users/ - pokračuje /jmeno-uzivatele/profilový-obrázek.png - složka s profilovým obrázkem uživatele

---

✍️ Administrace

Adresa: https://vas-web.cz/CMSLite/admin/

Vytvoření / editace článku

• Klikněte na "Vytvořit nový článek".
• Zadejte titulek → slug se generuje automaticky.
• Vyplňte obsah v CKEditor5: text, formátování, tabulky.
• Nahrajte náhledový obrázek (nahradí stávající).
• Přidejte tagy (oddělené čárkou, např. PHP, MySQL, Novinky).

Správa uživatelů

• Přidání nových uživatelů s rolí admin nebo redaktor.
• Hlavní admin (main-admin) má nejvyšší práva a nelze jej odstranit přes admin.

---

🌐 REST API – CMSLite

API poskytuje články a uživatele v JSON i XML.

🔹 Články

1. Detail článku

• JSON: https://vas-web.cz/CMSLite/api/json/articles.php?slug=nazev-clanku
• XML: https://vas-web.cz/CMSLite/api/xml/articles.php?slug=nazev-clanku

2. Seznam článků

• JSON: https://vas-web.cz/CMSLite/api/json/articles.php?list=all
• XML: https://vas-web.cz/CMSLite/api/xml/articles.php?list=all

Doporučeno jen pro omezené použití (plný obsah všech článků může být náročný na výkon).

🔹 Uživatelé

1. Seznam všech uživatelů

• JSON: https://vas-web.cz/CMSLite/api/json/users.php?list=all
• XML: https://vas-web.cz/CMSLite/api/xml/users.php?list=all

2. Detail uživatele podle ID

• JSON: https://vas-web.cz/CMSLite/api/json/users.php?id=1
• XML: https://vas-web.cz/CMSLite/api/xml/users.php?id=1

🔹 Bezpečnost API

• Povolené domény v settings.json → jen ty mohou volat API.
• GET metoda povolena, jiné metody vrací 405.
• Při prázdném seznamu povolených domén je API nepřístupné.

---

🌍 Vícejazyčnost

• Jazyk lze měnit v admin dashboard header.
• Aktuálně podporováno: CZ a EN.
• Přidání nového jazyka → vytvoření jazykového souboru a nastavení v admin.

🔹 Doporučení

• Při produkčním nasazení změň hlavní admin heslo.
• Omez volání ?list=all pro výkon.
• Sleduj role uživatelů a povolené domény pro API.
• Stylování admin rozhraní: TailwindCSS → rychlá úprava UI.

---

CMSLite by Vosoone.cz