Pošta: Porovnání verzí

Z Freenetis Wiki
Přejít na: navigace, hledání
m (Quimi přesunul stránku PoÅ¡ta na Pošta bez založení přesměrování)
 
(Není zobrazeno 17 mezilehlých verzí od 2 dalších uživatelů.)
Řádek 1: Řádek 1:
Modul pošta slouží ke komunikaci členů skrze freenetis. S jeho pomocí lze poslat zprávu jakémukoliv členovi (nebo uživatelovi).
+
Modul pošta slouží ke komunikaci členů skrze FreenetIS. S jeho pomocí lze poslat zprávu jakémukoliv členovi (nebo uživatelovi).
 +
 
 +
= Uživatelský pohled =
 +
 
 +
== Vzhled ==
  
 
Skládá se ze 3 základních částí:
 
Skládá se ze 3 základních částí:
  
== Doručená pošta ==
+
=== Doručená pošta ===
  
 
Zobrazuje doručenou počtu uživatele řazenou chronologicky od nejnovější zprávy po tu nejstarší.
 
Zobrazuje doručenou počtu uživatele řazenou chronologicky od nejnovější zprávy po tu nejstarší.
Řádek 9: Řádek 13:
 
Mimo to obsahuje jednoduché ovládání zpráv - je možné je hromadně mazat nebo je hromadně označovat jako přečtené nebo nepřečtené.
 
Mimo to obsahuje jednoduché ovládání zpráv - je možné je hromadně mazat nebo je hromadně označovat jako přečtené nebo nepřečtené.
  
== Odeslaná pošta ==
+
Je to vstupní část - dá se sem vstoupit přes kliknutí na obálku v horní části stránky nebo kliknutím na Moje pošta v menu Můj profil.
 +
 
 +
=== Odeslaná pošta ===
  
 
Zobrazuje všechny odeslané zprávy uživatele řazené chronologicky od nejnovější zprávy po tu nejstarší.
 
Zobrazuje všechny odeslané zprávy uživatele řazené chronologicky od nejnovější zprávy po tu nejstarší.
Řádek 15: Řádek 21:
 
Mimo to obsahuje jednoduché ovládání zpráv - je možné je hromadně mazat.
 
Mimo to obsahuje jednoduché ovládání zpráv - je možné je hromadně mazat.
  
== Napsat novou zprávu ==
+
=== Napsat novou zprávu ===
  
 
Obsahuje formulář pro napsání nové zprávy. Obsahuje 3 pole:
 
Obsahuje formulář pro napsání nové zprávy. Obsahuje 3 pole:
  
'''Komu:'''
+
'''Komu''' - textové pole, musí obsahovat login příjemce; nebo loginy příjemců (oddělené čárkou) TODO: Dodělat nějaké klikátko, kde si člověk bude moct naklikat příjemce.
 +
 
 +
'''Předmět''' - textové pole předmět zprávy
 +
 
 +
'''Text''' - samotný text zprávy, ve formě WYSIWYG editoru
 +
 
 +
Kromě psání nových zpráv se tento formulář používá pro psání odpovědí (automaticky do formuláře doplní login původního odesílatele/příjemce a cituje text původní zprávy).
 +
 
 +
== Signalizace ==
 +
 
 +
Na novou doručenou poštu je uživatel upozorněn změnou barvy obálky v horní části stránky (z bílé na zelenou).
 +
[[Soubor:Nova_posta.jpg]]
 +
 
 +
== Systémové použití ==
 +
 
 +
Jedním ze základním důvodů, proč zavést poštu do FreenetISu, byla potřeba vytvořit způsob, jakým bude systém upozorňovat na některé události. V praxi to funguje tak, že uživatelovi přijde zpráva od uživatele s ID 1 (freenetis).
 +
 
 +
Příklady - uživatel upozorněn, když:
 +
 
 +
- někdo jiný přidal/editoval/smazal jeho práci
 +
- pokud někdo přidal/editoval/smazal práci (může-li hlasovat)
 +
- pokud někdo přidal/editoval/smazal hlas k práci (je-li jeho nebo může-li hlasovat)
 +
- pokud byla práce schválena/zamítnuta (je-li jeho nebo může-li hlasovat)
 +
- atd.
 +
 
 +
Systém se samozřejmě snaží inteligentně a neposílat zprávu v případech, kdy uzná, že to není nutné. Příklad - nepošle uživatelovi zprávu, přidal-li si práci sám, atd.
 +
 
 +
= Programátorský pohled =
 +
 
 +
== Databázový popis ==
 +
 
 +
Všechny zprávy pošty jsou uloženy v tabulce mail_messages. Ta obsahuje sloupce:
 +
 
 +
'''id''' - jednoznačný identifikátor zprávy (primární klíč)
 +
 
 +
'''from_id''' - ID uživatele-odesílatele
 +
 
 +
'''to_id''' - ID uživatele-příjemce
 +
 
 +
'''subject''' - předmět zprávy
 +
 
 +
'''body''' - text zprávy
 +
 
 +
'''time''' - čas odeslání
 +
 
 +
'''readed''' - příznak, zda-li byla zpráva přečtená
 +
 
 +
'''from_deleted''' - odesílatel tuto zprvu smazal
 +
 
 +
'''to_deleted''' - příjemce tuto zprávu smazal
 +
 
 +
== Mazání zpráv ==
 +
 
 +
Protože je každá zpráva pro dvě strany, neprobíhá její mazání jako obvykle. Kdyby totiž uživatel A poslal zprávu uživateli B a poté A zprávu smazal ze svých odeslaných zpráv, zpráva by zmizela i B z jeho doručených.
 +
 
 +
Z toho důvodu musely být zavedeny sloupce from_deleted a to_deleted. Ty pak popisují, jestli příjemce/odesílatel smazal tuto zprávu. Teprve až v případě, že oba budou pravdivé, dojde ke skutečné smazání zprávy z databáze.

Aktuální verze z 31. 1. 2018, 14:17

Modul pošta slouží ke komunikaci členů skrze FreenetIS. S jeho pomocí lze poslat zprávu jakémukoliv členovi (nebo uživatelovi).

Uživatelský pohled

Vzhled

Skládá se ze 3 základních částí:

Doručená pošta

Zobrazuje doručenou počtu uživatele řazenou chronologicky od nejnovější zprávy po tu nejstarší.

Mimo to obsahuje jednoduché ovládání zpráv - je možné je hromadně mazat nebo je hromadně označovat jako přečtené nebo nepřečtené.

Je to vstupní část - dá se sem vstoupit přes kliknutí na obálku v horní části stránky nebo kliknutím na Moje pošta v menu Můj profil.

Odeslaná pošta

Zobrazuje všechny odeslané zprávy uživatele řazené chronologicky od nejnovější zprávy po tu nejstarší.

Mimo to obsahuje jednoduché ovládání zpráv - je možné je hromadně mazat.

Napsat novou zprávu

Obsahuje formulář pro napsání nové zprávy. Obsahuje 3 pole:

Komu - textové pole, musí obsahovat login příjemce; nebo loginy příjemců (oddělené čárkou) TODO: Dodělat nějaké klikátko, kde si člověk bude moct naklikat příjemce.

Předmět - textové pole předmět zprávy

Text - samotný text zprávy, ve formě WYSIWYG editoru

Kromě psání nových zpráv se tento formulář používá pro psání odpovědí (automaticky do formuláře doplní login původního odesílatele/příjemce a cituje text původní zprávy).

Signalizace

Na novou doručenou poštu je uživatel upozorněn změnou barvy obálky v horní části stránky (z bílé na zelenou). Nova posta.jpg

Systémové použití

Jedním ze základním důvodů, proč zavést poštu do FreenetISu, byla potřeba vytvořit způsob, jakým bude systém upozorňovat na některé události. V praxi to funguje tak, že uživatelovi přijde zpráva od uživatele s ID 1 (freenetis).

Příklady - uživatel upozorněn, když:

- někdo jiný přidal/editoval/smazal jeho práci
- pokud někdo přidal/editoval/smazal práci (může-li hlasovat)
- pokud někdo přidal/editoval/smazal hlas k práci (je-li jeho nebo může-li hlasovat)
- pokud byla práce schválena/zamítnuta (je-li jeho nebo může-li hlasovat)
- atd.

Systém se samozřejmě snaží inteligentně a neposílat zprávu v případech, kdy uzná, že to není nutné. Příklad - nepošle uživatelovi zprávu, přidal-li si práci sám, atd.

Programátorský pohled

Databázový popis

Všechny zprávy pošty jsou uloženy v tabulce mail_messages. Ta obsahuje sloupce:

id - jednoznačný identifikátor zprávy (primární klíč)

from_id - ID uživatele-odesílatele

to_id - ID uživatele-příjemce

subject - předmět zprávy

body - text zprávy

time - čas odeslání

readed - příznak, zda-li byla zpráva přečtená

from_deleted - odesílatel tuto zprvu smazal

to_deleted - příjemce tuto zprávu smazal

Mazání zpráv

Protože je každá zpráva pro dvě strany, neprobíhá její mazání jako obvykle. Kdyby totiž uživatel A poslal zprávu uživateli B a poté A zprávu smazal ze svých odeslaných zpráv, zpráva by zmizela i B z jeho doručených.

Z toho důvodu musely být zavedeny sloupce from_deleted a to_deleted. Ty pak popisují, jestli příjemce/odesílatel smazal tuto zprávu. Teprve až v případě, že oba budou pravdivé, dojde ke skutečné smazání zprávy z databáze.