Uživatelská příručka

Název: Nabídky pro studenty

Autor: Martin Kot

Systém slouží pro správu nabídek zaměstnání. Nabídky se ukládají do databáze MySQL a jsou zpřístupněny pomocí www stránek. Navíc je možnost automatického posílání e-mailů po přidání nebo změně nabídky. Systém je dělen na dvě části. Jedna je veřejně přístupná a slouží k zobrazení nabídek a registraci pro příjem e-mailů. Druhá část je chráněna autorizací pomocí jména a hesla a slouží k modifikaci, přidávání a mazání nabídek. Je zde také možno rušit záznamy na posílání e-mailů (např. při strátě hesla).

Celá aplikace je dostupná na http://home.vsb.cz/kot/dais3. Pro přístup k chráněné části je možno použít jméno: "karel4" a heslo: "karel".

  1. Instalace
  2. Ovládání aplikace
    1. Obecné ovládání
    2. Veřejně přístupná část
      1. Registrace emailu
      2. Změna a vyplnění emailu
    3. Část chráněná autorizací
      1. Výmaz emailových adres
      2. Nový inzerát
      3. Výmaz inzerátu
      4. Změna inzerátu
    4. Pomocná část pro zadání uživatelů

Instalace

Nejprve je potřeba umístit do jednoho adresáře přístupného přes http všechny soubory. Ve vybrané databázi pod vybraným uživatelem ne MySQL serveru je nutno pomocí skriptu “cre.sql” vytvořit tabulky pro aplikaci. K tomu poslouží např. tento příkaz: “mysql –p databaze <cre.sql” kde slovo databáze bude nahrazeno jménem zvolené databáze.

Následně je nutno opravit v souboru “config.php3” některé položky tak, aby odpovídaly skutečnosti (např. jméno serveru, uživatelské jméno atd.). Význam položek je popsán přímo v tomto souboru.

Pokud si přejete systém vyzkoušet je možno po vytvoření tabulek spustit skript “ins.sql” (obdobným způsobem jako dříve “cre.sql”). Tento soubor vyplní tabulku 20 ukázkovými inzeráty a vloží dva uživatele pro modifikaci (jména: ‘karel4’ resp. ’martin’ a hesla ‘karel’ resp. ‘kot’).

Odinstalování

Obdobným způsobem jako byly tabulky vytvořeny je možné tabulky odstranit pomocí skriptu “dal.sql”. Poté je možno všechny soubory aplikace smazat.

Ovládání aplikace

Obecné ovládání

Pokud se ve formuláři některé vstupní pole popsáno zeleným nápisem, je jeho vyplnění povinné. Pokud není vyplněn, je zobrazeno okno s varováním a kurzor je přesunut na nevyplněné místo. Pokud je v prohlížeči vypnut JavaScript, je podle aktuálního formuláře buď vypsána chyba na začátek stránky nebo je zobrazena nová stránka s chybovou hláškou a možností vrátit se a údaje doplnit (dříve vyplněné hodnoty se neztrácí, jen je nutno doplnit chybějící).

Veřejně přístupná část

Základem této části aplikace je stránka “zobr.php3” zobrazující všechny inzeráty uložené v databázi.

Registrace emailu

Odkaz "E-mail nabídky" slouží pro zaregistrování žádosti na posílání emailů. Po kliknutí ne něj se zobrazí stránka "prihl_mail.php3".

Použitím odkazu "Zpět na seznam inzerátů" je možno se vrátit zpět na úvodní stránku zobrazující inzeráty. Noví uživatelé mající zájem o dostávání emailů mohou stisknout tlačítko "Nový uživatel". Již registrování uživatelé mohou vyplnit své jméno a heslo a stiskem "Přihlásit se" budou mít možnost znovu zadat své osobní údaje. V obou případech se zobrazí stránka "reg_mail.php3".

Změna a vyplnění emailu

Použitím odkazu "Zpět na seznam inzerátů" je opět možno se vrátit zpět na úvodní stránku zobrazující inzeráty. Dříve registrování uživatelé mohou vyplnit formulář (všechny položky jsou povinné) a stiskem "Změnit" bude jejich záznam v tabulce nahrazen nově zadanými hodnotami . Při stisku "Zrušit" bude záznam daného uživatele odstraněn (již nebude dostávat emaily) a zobrazí se stejná stránka jako novým uživatelům.

Stránka pro nové uživatele se liší jen v tlačítkách. Je zde pouze jedno "Přidat" a po jeho stisku je záznam vyplněný ve formuláři zapsán do databáze. Oznámení o úspěchu operace se objeví na stránce a zobrazí se stránka umožňující přímo modifikaci a výmaz záznamu.

Volby "Upozornění" a "Celý text" určují formát, v jakém budou docházet emaily na vybranou adresu. Možnost "Upozornění" znamená jednu větu oznamující novou nabídku (tato volba je vhodná např. pro mobilní telefony). Volba "Celý text" znamená odeslání celého inzerátu.

Část chráněná autorizací

Nutnost autorizace lze jednoduše odstranit nastavením jedné položky v "config.php3" pokud je to pro uživatele vhodnější nebo pokud se předpokládá užití starých prohlížečů, které ji namusí podporovat.

Základem této části aplikace je stránka “seznam.php3” zobrazující všechny inzeráty uložené v databázi.

 

maz emailových adres

Odkaz "Příjemci e-mailu" zobrazí stránku se seznamem emailových adres a typem zprávy posílané na tyto adresy.

Stiskem tlačítka odstranit bude příslušný email odstraněn ze seznamu. Slouží to k administraci například při zapomenutí hesla uživatelem.

 

Nový inzerát

Odkaz přidat nový záznam na hlavní stránce slouží k zadání nového inzerátu do databáze. Zobrazí se stránka "new_inzerat.php3".

Výběr firmy spolu s tlačítkem "Vyplnit údaje dané firmy" slouží k ulehčení práce pokud je zadáván inzerát firmy, která již nějaký zadala dříve. V seznamu se vybere její jméno a stiskne se tlačítko. To vymaže obsah celého formuláře a do části pro údaje o firmě vyplní dříve evidované údaje. Pokud budou před odesláním formuláře změněna, změní se i u původního záznamu.

Ostatní položky slouží k zadání údajů, které budou zobrazeny k inzerátu. Výběr "Typ textu" umožňuje dvojí interpretaci obsahu pole text. Pokud je zvoleno "Čistý text", je text zobrazen stejně, jak je zapsán. Volba "HTML" umožní zadat do pole text HTML kód, který se potom při zobrazení interpretuje.

Pole "Odkaz na další informace" slouží k zadání URL stránky s dalšími informacemi týkajícími se daného inzerátu. Pole "www" slouží k zadání URL odkazu na stránky firmy. "E-mail" je kontaktní adresa firmy. Ostatní pole mohou být vyplněna jakkoliv, protože jejich obsahy jsou jen zobrazeny a nijak interpretovány. Tedy např. "Telefon" může obsahovat několik čísel oddělených nějakým oddělovačem a i formát čísla (oddělení předčíslí …) může být libovolný.

Tlačítko "Vyprázdnit formulář" vymaže dosud vyplněný obsah všech polí formuláře.

Tlačítko "Uložit" přidá záznam do databáze. Je zobrazena nová stránka ("info.php3") informující o úspěchu nebo neúspěchu. Z ní je možno se odkazem vrátit na hlavní stránku seznamu inzerátů.

Výmaz inzerátu

Na hlavní stránce je u každého inzerátu odkaz "Smazat inzerát". Po jeho stisku se zobrazí stránka "smazat_inz.php3". Dále je možno se na ni dostat odkazem ze stránky pro modifikaci záznamu.

Na této stránce se vybraný inzerát znovu zobrazí. Odkaz změnit záznam ukazuje na stránku "opr_inzerat.php3", kde je možno záznam modifikovat. "Zpět na seznam" (odkaz i tlačítko) slouží k návratu na hlavní stránku."

Pokud má firma v databázi jen jeden inzerát, jsou k dispozici 2 tlačítka. "Smazat jen inzerát" odstraní záznam inzerátu, ale při zadávání nového je firma pořád uvedena v seznamu a nemusí se potom údaje znovu vyplňovat. "Smazat inzerát i firmu" odstraní inzerát spolu se záznamem firmy. Ta již pak nebude k dispozici pro nové inzeráty a bude se případně muset vyplnit znovu. V obou případech je zobrazena nová stránka ("info.php3") informující o úspěchu nebo neúspěchu. Z ní je možno se odkazem vrátit na hlavní stránku seznamu inzerátů.

Změna inzerátu

Odkazy "Změnit záznam" z hlavní stránky a ze stránky pro výmaz vedou na stránku "opr_inzerat.php3". Na ní jsou v podobném formuláři jako při novém inzerátu zobrazeny původní údaje. Na rozdíl od formuláře pro nový inzerát již zde není možno vybírat firmu ze seznamu.

Na stránce je k dispozici odkaz na stránku výmazu daného inzerátu.

Jednotlivá pole se vyplňují obdobně jako při novém inzerátu.

Po stisku tlačítka "Uložit" jsou změny záznamu uloženy. Pokud se změnilo něco v části záznamu firmy a firma zadala již více inzerátů, zobrazí se ještě stránka "update_inzerat.php3".

Tlačítko "Opravit všechny" aplikuje změny v údajích firmy na její záznam a tím se projeví u všech inzerátů dané firmy (užívá se při změně některých skutečností o dané firmě). Tlačítko "Opravit vybraný" vytvoří nový záznam firmy a tím zůstanou údaje u předchozích inzerátů nezměněny (slouží při opravě chybného přiřazení firmy k inzerátu, jejímu rozdělení na dvě části, změně pobočky starající se o danou nabídku apod.). V obou případech je zobrazena nová stránka ("info.php3") informující o úspěchu nebo neúspěchu. Z ní je možno se odkazem vrátit na hlavní stránku seznamu inzerátů.

Pomocná část pro zadání uživatelů

Z důvodů autentikace je potřeba mít uložena v tabulce jména a heslo uživatelů oprávněných modifikovat záznamy. Pro jednodušší zadávání obsahuje aplikace jednoduchou stránku "uzivatel.php3".

Na ni je možno stiskem tlačítka odebrat libovolného uživatele. Odkaz "Přidat uživatele" vede na stránku "uziv_pridat.php3".

Tady je možno zadat nové jméno člověka, jeho heslo a stiskem tlačítka "Zaregistrovat" přidat člověka do databáze. Na stránce se objeví oznámení o výsledku operace a ihned je možno přidat dalšího člověka.