<?PHP

/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  Our Help Sections
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
$help_sections = array();

//----------------------------------
// Including the News
//----------------------------------
$help_sections["including"] = <<<HTML
<h1>Hírek beillesztése</h1>
Miután a CuteNews híríró programot sikeresen telepítetted, elkezdhetsz híreket írni. Ahhoz hogy megjelenítsd őket, be kell hívnod a
<b>show_news.php</b> fájlt egy egyszerű PHP include függvénnyel:
<div class="code">&lt;?PHP<br>
include("cutenews/show_news.php");<br>
?&gt;</div>
Helyettesítsd be a <i>cutenews/show_news.php</i>-t a CuteNews helyével a szervereden, de <b>NE</b> az URL-t írd be!!!<br>
Példák:<br>
<font color=green>HELYES</font>: include("cutenews/show_news.php");<br>
<font color=red>HELYTELEN</font>: include("http://oldalad.hu/cutenews/show_news.php");<br>
<br>
Figyelj arra, hogy ahhoz hogy használni tudd ezt a PHP kódot, a fájlnak, amibe beilleszted .php kiterjesztésűnek kell lennie, másként nem fog működni.
HTML;

//----------------------------------
// All possible variables while including
//----------------------------------
$help_sections["variables"] = <<<HTML
<h1>Változók a hírek testreszabásához</h1>
A következő változókat használhatód az include kód előtt, mindegyik különböző finomításokat tartalmaz:<br>
<div class="code" style='font-family: Verdana, Arial, Helvetica, sans-serif;'>&lt;?PHP<br><br>
<b>\$number = "&lt;X&gt;";</b>&nbsp;&nbsp;<i>// csak az X legújabb hírt mutatja</i><br>
<b>\$template = "&lt;NAME&gt;";</b>&nbsp;&nbsp;<i>// ha nem a Default sablont akarod a hírek megjelenítésére használni, használd ezt a változót</i><br>
<b>\$static = TRUE;</b>&nbsp;&nbsp;<i>// ez a funkció a 'Dupla Include'-knál hasznos</i><br>
<b>\$category = "&lt;ID&gt;";</b>&nbsp;&nbsp;<i>// hírek mutatása egy kiválasztott kategóriából, ahol az ID a kategória azonosítója (többet vesszővel tudsz elválasztani)</i><br>
<b>\$start_from = "&lt;NUMBER&gt;";</b>&nbsp;&nbsp;<i>// pl. ha kettőre állítod, az első két hír át lesz ugorva, és csak az utána következők lesznek megjelenítve; akkor kell használnod, ha a \$number = "X"; változót is használod</i><br>

<br>include("cutenews/show_news.php");<br>
?&gt;</div>
Egyik változót sem kötelező használni, csak a testreszabásra szolgálnak.
HTML;

//----------------------------------
// Using Multiple Includes
//----------------------------------
$help_sections["multiple_includes"] = <<<HTML
<h1>Dupla includeok</h1>
Most azt a szituációt fogjuk megvizsgálni, amikor több include kódot szeretnél egy oldalra beilleszteni. Ha például csak az utolsó öt főcímet szeretnéd megjeleníteni 
(a headlines sablont használva) és alatta normálisan a többi hírt. A probléma az, hogy ha a főcímre rákattintasz, a CuteNews nem tudja, hogy hova jelenítse meg 
a híreket: a főcímekhez vagy a normális hírekhez. A megoldás pedig a <b>\$static = TRUE;</b> változó használata. Ahol ezt a változót használod, a CuteNews tudni fogja, 
hogy oda nem szabad megjelenítenie a teljes hírt (mikor a főcímre kattintunk).<br>
Itt egy helyes kód a főcímek és normál hírek egyszerre történő használatára:
<div class="code">&lt;?PHP<br>
<u>Utolsó öt főcím</u>:<br>
\$static = TRUE;<br>
\$number = "5";<br>
\$template = "Headlines";<br>
include("cutenews/show_news.php");<br>
<br>
<u>Normál hírek</u><br>
include("path/to/show_news.php");<br>
?&gt;</div>
Most ha rákattintasz a főcímre, akkor a hozzá tartozó hír a normál híreknél fog megjelenni.<br><br>
Próbálkozz a <b>\$static = TRUE;</b> használatával, és majd rájössz, hogyan műküdik és milyen hasznos tud lenni!

HTML;

//----------------------------------
// Users Section
//----------------------------------
$help_sections["users"] = <<<HTML
<h1>Felhasználói szintek értelmezése</h1>
Biztonsági okok, könnyebb kezelhetőség és a rugalmasság miatt négy felhasználói szint található meg a CuteNewsben.
Ezek közül mindegyiknek korlátozott hozzáférése van a szkript különböző részeihez, amelyeket manuálisan nem lehet megváltoztatni.<br>
A felhasználó szintek a következők:<br>
<ol>
<li><b>Admin</b> - az adminisztrátoroknak teljeskörű hozzáférésük van a szkripthez: szerkeszthetik mások híreit, hozzászólásait, kitilthatnak felhasználókat, és hozzáférnek a rendszerkonfigurációhoz is - figyelj kinek adsz adminisztrátori jogosultságokat!!!</li>
<br>
<li><b>Szerkesztők</b> - a szerkesztők írhatnak híreket, és szerkeszthetik és jóváhagyhatják az írók által írt híreket is.</li>
<br>
<li><b>Írók</b> - az írók írhatnak híreket, és szerkeszthetik is azokat. Csak a saját híreiket szerkeszthetik, és azokat vagy egy szerkesztőnek vagy egy adminnak jóvá kell hagynia.</li>
<br>
<li><b>Hozzászólók</b> - a hozzászólók csak a jelszavaikat változtathatják az admin panelen belül. Ez a felhasználói szint akkor hasznos, ha egy hozzászóló jelszóval akarja védeni a nevét, hogy mások ne szólhassanak hozzá az ő nevével.</li>
</ol>
HTML;

//----------------------------------
// Categories Section
//----------------------------------
$help_sections["categories"] = <<<HTML
<h1>Mik azok a kategóriák és hogyan használjam őket?</h1>
A hozzáadott kategóriákat a 'Hozzáadás' menüben fogod látni. Tehát ha írsz egy hírt, azt beleteheted különböző kategóriákba 
(egybe vagy akár többe is, de ki is hagyhatod a kategorizálást), így könnyen rendezni tudod a híreket. Amikor egy kategóriát 
hozzáadsz, megadhatsz neki egy nevet, ha akarsz, egy pici ikont is, és a rendszer automatikusan generál a kategóriához egy ID-t, 
vagyis egy azonosító számot. Ezzel az azonosítószámmal tudod a hír beillesztésénél megadni, hogy melyik kategóriá(k)ból akarod a hírt 
megjeleníteni. Példa kód:<div class="code">&lt;?PHP<br>
\$category = "<b>2</b>";<br>include("cutenews/show_news.php");<br>
?&gt;</div>
A felső kód az összes hírt meg fogja jeleníteni a 2-es azonosítószámú kategóriából.<br>
Ha van 5 kategóriád, és azt szeretnéd, hogy csak három kategóriából jelenítse meg a híreket a következő kódot használd:
<div class="code">&lt;?PHP<br>
\$category = "<b>2</b>,<b>3</b>,<b>5</b>";<br>include("cutenews/show_news.php");<br>
?&gt;</div>
Tehát a felső kód az összes hírt meg fogja jeleníteni a 2-es, 3-as és 4-es azonosítószámú kategóriákból.<br>
Ha <b>nem</b> használod ezt a \$category = "&lt;ID&gt;"; kódot, a CuteNews az összes kategóriából meg fogja jeleníteni a híreket.<br><br>
Ha megadsz a kategóriának ikont, a sablonokban be kell állítanod, hogy megjelenjen, a {category-icon} kóddal.
HTML;

//----------------------------------
// Templates Section
//----------------------------------
$help_sections["templates"] = <<<HTML
<h1>Sablonok értelmezése</h1>
A sablonok a hírek kinézetének változtatására szolgálnak. Különböző részeket szerkesztve a hír különböző részeit tudod szerkeszteni. Például az Aktív hírek résszel 
az aktív hírek kinézetét tudod változtatni, a Teljes hír résszel a teljes hírét, a Hozzászólások résszel pedig a hozzászólásokét és így tovább.<br><br>
Amikor szerkesztesz egy sablont, használhatsz HTML tag-eket. De ahhoz, hogy a hír címét vagy írásának dátumát megjelenítsd, speciális kódokat kell beírnod, amelyek 
minden résznél ott szerepelnek magyarázattal együtt. Vegyük például az Aktív Híreket: mikor lenyitod ezt a részt, egy hosszú lista válik láthatóvá, ezekkel a 
speciális kódokkal. Az egyik fő és könnyű kód a  <b>{title}</b>. Ahová ezt teszed, ott fog megjelenni az adott hír címe.<br><br>
Csinálhatsz több sablont is, ez például akkor hasznos, ha az oldaladon több kinézet közül lehet váltani, és mindegyik kinézetnél másként kell, hogy a hírek kinézzenek, 
vagy csak egyszerűen szereted a változatosságot. Ahhoz, hogy ezek közül a sablonok közül választani tudj, szintén az include kódhoz kell hozzáadnod a \$template változót, 
a következő módon:
<br>
<div class="code">&lt;?PHP<br>
\$template = "elso_kinezet";<br>include("cutenews/show_news.php");<br>
?&gt;</div>A felső kóddal az 'elso_kinezet' nevű sablonnal fognak a hírek megjelenni. Ha nem adod meg, hogy melyik sablont használja a szkript, a 'Default' sablon 
lesz az alapértelmezett. Ezt a sablont nem lehet törölni, de természetesen szerkeszteni igen.
HTML;

//----------------------------------
// Archives Section
//----------------------------------
$help_sections["archives"] = <<<HTML
<h1>Archívum értelmezése és használata</h1>
Mikor archiválod a híreket, a CuteNews automatikusan létrehoz egy fájlt az ./archives/ könyvtárban az .arch kiterjesztéssel.
Így az összes hír, amit kiválasztottál archiválásra - a news.txt fájlból - át lesznek másolva az archives/ könyvtáron belül az adott fájlba.
Tehát az archivált hírek nem a show_news.php fájlból lesznek elérhetők, hanem a show_archives.php fájlból.<br><br>
Mikor az összes hírt archiválod, nem lesznek a news.txt-ben aktív hírek, de ha a  \$number = <b>X</b>; változót beszúrod az include kódba, 
a CuteNews automatikusan meg fogja jeleníteni az utolsó X hírt (feltéve, ha az \$only_active változó nincs megadva az includekódban).<br><br>
Az archiválás nem szükséges, talán sohasem fogod használni, de ha több, mint 3000 aktív híred van, ajánlott archiválni.
HTML;

//----------------------------------
// Adding News Options
//----------------------------------
$help_sections["addnews_options"] = <<<HTML
<h1>Beállítások hír hozzáadásánál</h1>
Mikor írsz vagy szerkesztesz egy adott hírt, rendelkezésedre áll pár beállítás.
<ul>
<li><b>Sortörések átalakítása &lt;br /&gt;-ré</b> - ha be van pipálva, a híren belüli összes sortörés a HTML-nek megfelelő sortörés taggé lesz átalakítva.</li>
<li><b>HTML engedélyezése </b> - ha be van pipálva, a CuteNews a HTML kódokat is figyelembe veszi, ha nincs, akkor csak egy egyszerű szövegként fogja kezelni.</li>
<li><b>Normal</b> -  ha ezt az opciót választod, a hír azonnal hozzá lesz adva és láthatóvá válik</li>
<li><b>Piszkozat</b> -  ha ezt az opciót választod, a hír hozzá lesz adva, de nem lesz látható, csak ha te vagy valaki más jóváhagyja.
<li><b>Halasztott</b> -  ha ezt az opciót választod, a hír nem lesz hozzáadva a kiválasztott időpontig.
</ul>
HTML;

/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  Load the specified section in PopUp Window
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
if(isset($section)){
        if(!isset($help_sections["$section"])){ die("Nem találom a <b>$section</b> részt."); }
        echo"<HTML>
    <style type=\"text/css\">
        <!--
        a:active,a:visited,a:link {color: #446488; text-decoration: none; font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 8pt;}
        a:hover {color: #00004F; text-decoration: none; font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 8pt; }
        .code {
                font-family : Andale Mono, Courier;
                border: 1px solid #BBCDDB;
                margin:10px;
                padding:4px;
                background:#FBFFFF;
        }
    h1 {
                background-color : #BBCDDB;
                border-bottom : #000000 1px solid;
                border-top : #000000 1px solid;
                color : #000000;
                font-family : Tahoma, Verdana, Arial, Helvetica, sans-serif;
                font-size : 16px;
                font-weight : bold;
                margin : -10px 0px 10px 0px;
                padding-bottom : 5px;
                padding-left : 10px;
                padding-right : 10px;
                padding-top : 5px;
                text-decoration : none;
                margin-left: -10px;
                margin-right: -8px;
        }
        BODY, TD, TR {text-align:justify ;padding: 0; text-decoration: none; font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 8pt; cursor: default;}
        -->
        </style>
    <TITLE>HELP - $section</TITLE>
    <BODY>
                ". $help_sections["$section"] ."
    </BODY></HTML>";
}

else{

        echoheader("question", "Dokumentáció");
    echo"<style type=\"text/css\">
        <!--
        .code {
                font-family : Andale Mono, Courier;
                border: 1px solid #BBCDDB;
                margin:10px;
                padding:4px;
                background:#FBFFFF;
        }
    h1 {
                background-color : #EAF0F4;
                border-bottom : #000000 1px solid;
                border-top : #000000 1px solid;
                border-left : #000000 1px solid;

                color : #000000;
                font-family : Tahoma, Verdana, Arial, Helvetica, sans-serif;
                font-size : 15px;
                font-weight : bold;
                padding-bottom : 5px;
                padding-left : 10px;
                padding-right : 10px;
                padding-top : 5px;
                text-decoration : none;
        }
        -->
        </style>";
    foreach($help_sections as $help_section){
            echo"$help_section<BR><br>";
    }

        echofooter();
}
?>