PersonaOne CMS 1.2.3#
Kompletní instalační, uživatelská a bezpečnostní příručka#
PersonaOne je prodejná PHP šablona osobní vizitky, portfolia a malého firemního webu. Obsahuje místní administraci, tři jazyky, blog, galerii obrázků i MP4 videí, vlastní stránky, vzhledová témata, licenční ochranu a bezpečné aktualizace celým ZIPem.
1. Obsah zákaznického balíčku#
- veřejný web v CZ, EN a DE,
- vícejazyčný instalátor,
- místní účty Administrator a Editor bez veřejné registrace,
- profil, bio, služby, dovednosti, zkušenosti a reference,
- vlastní stránky, blog a galerie,
- JPG, PNG a WEBP do 8 MB; MP4 do 64 MB,
- osm vzhledových témat a vlastní barevný akcent,
- kontaktní formulář, místní zprávy a auditní stopa,
- startovní stránky Soukromí, Cookies a Podmínky,
- volitelné upozornění pro publicistický, bulvární, satirický nebo zábavní projekt,
- licenční edice Standard a Pro,
- podepsané aktualizační ZIPy se zálohou a automatickým vrácením změn.
2. Požadavky serveru#
PHP 8.1+, rozšíření JSON, Fileinfo, Sodium, Sessions a ZipArchive, HTTPS, allow_url_fopen = On, Apache mod_rewrite nebo dodaná konfigurace Nginx. storage/, storage/uploads/ a při instalaci config/ musí být zapisovatelné.
Limity PHP musí být vyšší než nahrávaný soubor. Pro MP4 do 64 MB nastavte například upload_max_filesize = 70M a post_max_size = 75M. Po změně konfigurace restartujte příslušné PHP-FPM.
3. Instalace do složky za /www#
Rozbalte obsah ZIPu přímo například do /www/klient-web, ne do další vnořené složky.
mkdir -p /www/klient-web
unzip personaone-template-v1.2.3.zip -d /www/klient-web
chown -R www-data:www-data /www/klient-web
find /www/klient-web -type d -exec chmod 755 {} \;
find /www/klient-web -type f -exec chmod 644 {} \;
chmod 775 /www/klient-web/storage /www/klient-web/storage/uploads /www/klient-web/config
Nasměrujte doménu na tuto složku a otevřete https://vase-domena.cz/install. Instalátor lze nahoře přepnout CZ / EN / DE. Vyplňte účet správce, licenci a endpointy dodané prodejcem. Recovery code uložte mimo server. Administrace je na /admin/login, dokumentace na /docs/.
4. Jazyky v administraci#
Vpravo nahoře v celé administraci jsou tři přímá tlačítka CZ / EN / DE. Každé kliknutí odešle volbu přímo serveru bez závislosti na JavaScriptu, uloží ji do aktuální relace i trvale k uživatelskému účtu. Administrator tedy může pracovat česky a Editor současně německy nebo anglicky.
Položka Jazyky / web řídí něco jiného: veřejné jazykové verze webu. Zapněte libovolnou kombinaci CZ, EN a DE a nastavte výchozí jazyk. Musí zůstat aktivní alespoň jeden. Vypnutí jazyka nesmaže překlady, pouze skryje veřejnou variantu a přepínač.
Vícejazyčná pole zůstávají dostupná pro CZ, EN a DE. Nevyplněný překlad se při zobrazení pokusí použít českou nebo první dostupnou hodnotu.
5. Profil, sekce a vlastní stránky#
V Profilu změňte jméno, titul, slogan, bio, kontakty, lokalitu, fotografii a sociální odkazy. V Sekcích spravujte služby, dovednosti, časovou osu a reference.
V Stránkách lze vytvořit další stránku s vlastním slugem, překladem a publikací v menu. Obsah používá bezpečný Markdown: nadpisy, tučné písmo, kurzívu, seznamy a odkazy. Libovolné HTML se nevykonává.
6. Blog#
V Blogu vytvořte článek, vyplňte slug, datum, názvy, perexy a obsah v CZ/EN/DE. Lze přidat titulní JPG, PNG nebo WEBP. Článek může být koncept nebo publikovaný.
Publikované články se zobrazí na /blog, poslední tři také na domovské stránce. Slug musí být jedinečný. Při výměně nebo odstranění titulního obrázku se starý soubor bezpečně smaže.
7. Galerie obrázků a MP4#
V Galerii nahrajte JPG, PNG, WEBP nebo MP4 a doplňte popisek pro každý jazyk. Obrázky mají limit 8 MB, MP4 64 MB. Aplikace kontroluje MIME typ, u obrázků ověřuje strukturu a u MP4 kontroluje kontejner ftyp. Soubor dostane náhodný název.
Prázdná galerie se ve veřejném menu nezobrazuje. Po prvním médiu se odkaz i sekce objeví automaticky. MP4 se přehrává místně pomocí HTML5 přehrávače. Pro delší nebo velmi kvalitní videa je vhodnější externí video hosting, protože přenos zatěžuje server.
8. Vzhled a licence Standard / Pro#
V Vzhledu je osm témat, vlastní akcent, velikost písma a tvar rohů.
- Standard: zpravidla jedna doména, povinný odkaz „Created by FussyCraft / Lajkto“, 6 měsíců podpory a 12 měsíců aktualizací podle nákupních podmínek.
- Pro: white-label oprávnění, možnost skrýt odkaz, obvykle produkční a staging doména, 24 měsíců podpory a aktualizací podle nákupních podmínek.
Edici určuje individuální podepsaný licenční klíč. Stejný instalační ZIP se odemkne podle klíče. Jeden nákup/projekt má mít vlastní klíč.
9. Uživatelé a bezpečnost#
Administrator má plný přístup. Editor spravuje obsah, stránky, blog, galerii a zprávy, ale ne licenci, uživatele, právní údaje ani aktualizace. Hesla se ukládají Argon2id, přihlášení má limit pokusů, formuláře CSRF ochranu a uploady whitelist typů.
Veřejná registrace neexistuje. Používejte HTTPS, silná unikátní hesla, pravidelné aktualizace, správná práva souborů a zálohy mimo webový root.
10. Aktualizace celým ZIPem#
Po instalaci verze 1.2.3 otevřete Aktualizace. Nahrajte celý originální zákaznický soubor personaone-template-vX.Y.Z.zip a potvrďte aktualizaci.
Aktualizátor:
- ověří ZIP, produkt, vyšší verzi a kryptografický podpis prodejce,
- odmítne cesty mimo web, symbolické odkazy a podezřelé archivy,
- vytvoří transakční zálohu měněných souborů,
- nikdy nepřepíše
storage/aniconfig/, - nahradí systémové soubory atomicky,
- při chybě automaticky obnoví předchozí stav.
Zálohy aktualizací jsou ve storage/backups/. První přechod ze starší verze bez aktualizačního panelu se provede ručním rozbalením přes webové soubory; data v storage/ a konfigurace zůstanou zachovány. Další aktualizace už probíhají v administraci.
11. Právní údaje, cookies a odpovědnost#
Dodané právní texty jsou pouze editovatelná startovní pomůcka. Provozovatel musí doplnit skutečné identifikační údaje, účely a právní základy zpracování, retenční lhůty, hosting, e-mail, analytiku, příjemce dat, přenosy mimo EHP, autorská práva a případné spotřebitelské povinnosti. Finální znění nechte posoudit právníkem pro zemi provozu a cílové publikum.
Jádro používá technicky nezbytnou session cookie pro administraci, CSRF a jazyk. Analytické a marketingové nástroje nejsou automaticky vkládány. Pokud je doplníte, zajistěte odpovídající informování, správu souhlasu a blokování před souhlasem tam, kde je vyžadováno. Označení obsahu jako bulvár, satira nebo zábava samo o sobě neruší odpovědnost za obsah, osobnostní práva, pomluvu, autorská práva ani soukromí.
Oficiální zdroje pro kontrolu aktuálních povinností:
- GDPR: https://eur-lex.europa.eu/eli/reg/2016/679/oj
- Cookies a ochrana údajů v ČR: https://uoou.gov.cz/cookies
12. Zálohování#
Zálohujte nejméně storage/data.json, storage/uploads/, storage/license.json, storage/installation.id a config/installed.php.
tar -czf /backup/personaone-$(date +%F-%H%M).tar.gz /www/klient-web
Zálohu uchovávejte mimo /www a pravidelně testujte obnovení.
13. Rozsah podpory#
Podpora zahrnuje reprodukovatelné chyby produktu, pomoc s instalací podle návodu, vysvětlení funkcí a kompatibilitní či bezpečnostní opravy během nároku. Nezahrnuje bezplatnou tvorbu obsahu, překlady, právní revize, správu VPS/DNS/e-mailu, vlastní vývoj, integrace třetích stran, migrace, opravu napadeného serveru ani neomezené školení.
14. Řešení problémů#
- Galerie nic neudělá: pokud je prázdná, veřejný odkaz je skrytý. Média přidejte v Administrace → Galerie.
- Jazyky nejsou vidět: otevřete Administrace → Jazyky / web. Po aktualizaci proveďte tvrdé obnovení prohlížeče.
- MP4 nejde nahrát: zkontrolujte
upload_max_filesize,post_max_size, Fileinfo, právastorage/uploads/a že jde skutečně o MP4 kontejner. - ZIP aktualizace selže: použijte originální novější zákaznický ZIP, ne Vendor Bundle; ověřte ZipArchive a velikostní limity.
- 403 u dokumentace:
.htaccessmusí obsahovatDirectoryIndex index.php index.html. - Přesměrování nefunguje: povolte Apache
mod_rewriteaAllowOverride All, nebo použijte dodaný Nginx blok. - Licence nesedí na www: produkt normalizuje
www.domena.cznadomena.cz; doporučené je přesměrovatwwwna jednu hlavní variantu.
Kontaktní formulář
Formulář přijme libovolnou neprázdnou zprávu. Chyby se zobrazují přímo u formuláře a vyplněné údaje zůstávají zachované. Úspěšné zprávy najdete v Administrace → Zprávy, pokud je zapnuté místní ukládání.