######################################################################

phpRS Plug-in modul: KForum v. 1.3.2
určeno pro phpRS verzi 2.8.0

kontakt na autora - Lubomír Kupka
lubomir.kupka@saton.cz

######################################################################

Tato verze je po betatestu. Je plně funkční, ale mohou se v ní najít ještě drobnosti na doladění.

Uvnitř najdete některá nastavení a části, které nejsou využívány. Je s nimi počítáno v další verzi.


Přehled verzí

  05.11.2006 - kforum131.zip - základní verze 1.3.0 - jen pro phpRS 2.8.0
     - přidán systémový blok - poslední příspěvky
     - konfigurace kfora v admin menu
     - tři úrovně moderátorů
     - možnost používání avatarů - ale prozatím jen omezeně co do složitosti přidávání
     - a změny ve vnitřní struktuře ... ty sice vidět nejsou, ale jsou výrazné
    
     - na četná přání změněno:
        - zrušeno zobrazování moderátora v přehledu tém
        - moderátor témy se nastavuje až při její editaci, při založení je jako moderátor nastaven autor
        - hlídání maximální délky slova v podtitulu a příspěvku ... a na poslední chvíli v systémovém bloku ... nj, dík :)
    
  21.11.2006 - kforum132upg.zip - upgrade na verzi 1.3.1
     - opraveny drobné chyby
     - do admin rozhraní přidán přepínač zobrazování jméno/přezdívka
     - v souvislosti s tím přidáno nastavení délky zobrazovaného jména
     - nastavení zobrazovací šablony pro kforum přes combobox
     - do fora přidána možnost přesunu téma mezi kategoriemi (pro správce fora)



Instalace

  1. instalace databází
    Pomocí souboru sql_v131.sql vytvořit na webu potřebné soubory. Jedná se o databáze:
    • frum - kategorie
    • frumtop - témata
    • frumpst - příspěvky
    • frumid - evidence návštěv registrovaných uživatelů
    • frumcfg - konfigurace kfora
    • frumidinf - uživatelské informace - nevyužíváno, připraveno pro novou verzi

  2. nakopírování souborů - které a kam
    kforum131.zip - rozbalit a nakopírovat na web tak, jak jsou adresáře v zipu nastíněny.

  3. barvy, písma
    Obsah souboru css.txt z adresáře install přikopírujte na konec souboru css v adresáři aktuálně používaného layoutu. Nastavení barev v instalaci zhruba odpovídá layoutu FreeStyle2006.

  4. instalace pluginu
    Běžná, neliší se od standardní instalace. V admin rozhraní v menu Konfigurace/Správa pluginů nainstalujte plugin/kforum/plugin.php

  5. configurace
    veškeré nastavení KFora je oproti starším verzím přesunuto do admin části

  6. systémový blok
    po instalaci máte možnost zapnout systémový blok kforum. V něm se Vám zobrazí poslední příspěvky z fora. Můžete nastavit jejich počet a jak velká část se z názvu témy a samotného příspěvku zobrazí. Jelikož se toto nastavení provádí většinou jen jednou, jsou tyto proměnné prozatím přístupné jen ve zdroji (řádek 100-103 v plugin/kforum/knove.php)

  7. spuštění
    odkaz kforum.php
Poznámka
* změna názvů adresářů je možná, jen pamatujte současně na změny v config.php, plugin.php, rozcestnik.php a odkaz na khelp.htm přímo v kforum.php *
* na web není nutné kopírovat adresář install, kde jsou soubory využívané k instalaci *



Upgrade


1.2.2 -> 1.3.1
- jelikož se jedná o přechod mezi verzemi phpRS, soubory se budou jen kopírovat a ne přepisovat
- databázové tabulky pro kforum z verze 1.2.2 se dají použít beze změny. Jediná změna je v přidání indexů.

1.3.1 -> 1.3.2
- prosté nakopírování obsahu kforum132upg.zip
- databázové tabulky doplnit pomocí scriptu sql_upg_v122_v123.sql. Doplnění dvou hodnot do konfigurační databáze.



Zajímavosti


Odstraňování HTML tagu (proměnná $odstranitHTML umístěna na začátku kforum.php)
- TRUE z textů všeho druhu budou odstaňovány HTML tagy (doporučeno)
- FALSE v textech zůstanou zachovány funkční HTML tagy

Zobrazovat [] tagy v podtitulu u téma (proměnná $HTMLpodtit umístěna na začátku kforum.php)
- TRUE v podtitulu u téma budou zobrazovány [] tagy
- FALSE podtitul u téma bude čistý text (doporučeno)

Hlídání maximální velikosti slova v podtitulu u téma (proměnná $maxslovopopis umístěna na začátku kforum.php)
- velikost udává maximální délku slova ve znacích

Hlídání maximální velikosti slova v příspěvku (proměnná $maxslovopst umístěna na začátku kforum.php)
- velikost udává maximální délku slova ve znacích



Stručný, opravdu jen stručný, popis

Forum se skládá ze tří úrovní. Kategorie, Témata a samotné Příspěvky.

Kategorie se zadávají pouze v admin modulu. Běžný uživatel je nemůže zakládat, opravovat ani rušit.
Téma může založit kterýkoli registrovaný uživatel. On jako autor a jím určený moderátor mohou toto téma opravovat, zrušit a provádět změny v kterémkoli uvnitř vložených příspěvků (ano, i jejich zrušení).
Příspěvky jsou poslední úrovní a může je vkládat kterýkoli registrovaný uživatel. Svoje příspěvky může každý opravovat i rušit.

Nepřihlášený návštěvník webu může celé forum jen pročítat.

Kategorie a témata je možno uzamčením přepnout do stavu pouze pro čtení. Také je možné je ukotvit, takže stále zůstavají na začátku přehledu. Standardně jsou témata tříděna dle data poslední změny, která v nich proběhla (vložení nového nebo editace existujícího příspěvku).

U každého registrovaného uživatele se vede evidence návštěv. Tím je možné zobrazovat počet nových příspěvků od jeho poslední návštěvy a to u každého z témat zvlášť.