Powered by slightly modified MediaWiki and TED Notepad.

Dev:Classes/Albums

Image:Classes_-_Albums.png

Navigation: Dev:Classes.

Contents

Uvod

Trieda: AlbumDirectory


name type description
parent link Nadadresar daneho adresaru.
icon link Hlavna fotka adresaru, zobrazujuca sa v nadadresaroch ako ikonka. Moze to byt napriklad uputavka na dany adresar, alebo fotka reprezentujuca obsah adresaru. Vid triedu Photo.
name string Nazov adresaru. Musi byt unikatny v danej ceste adresarov.
description text Popis adresaru.
state enum Stav adresaru. Moznosti:
  • suggested - Adresar bol navrhnuty beznym uzivatelom, ktory nemal prava na spravovanie adresarov. Poznamka: Pri navrhovani sa zvysuje atribut wanted_count. Vid tiez atribut GlobalSettings.Album.allow_user_directories.
  • approved - Adresar bol vytvoreny alebo potvrdeny uzivatelom, ktory mal prava na spravovanie adresarov. Vid atribut User.AdminSettings.may_manage_directories.
  • hidden - Adresar je skryty a nezobrazuje sa beznym uzivatelom v prehladoch adresarov.
no_albums bool Hovori, ci v adresari smu byt nejake nove albumy. Pokial nie, do adresaru je mozne pridavat iba dalsie podadresare. Nijak neovplyvnuje uz vytvorene albumy. Vid tiez atribut no_directories.
no_directories bool Hovori, ci uzivatelia mozu v danom adresari vytvarat/navrhovat nove podadresare. Pokial nie, do adresaru je mozne uz iba pridavat dalsie albumy. Nijak neovplyvnuje uz vytvorene podadresare.

Poznamka: Pokial su nastavene oba atributy, no_albums aj no_directories sucasne, adresar je prakticky uzavrety a ziadne dalsie albumy ci podadresare sa nedaju vytvorit. To vsak nebrani tomu, aby existujuce podadresare alebo albumy normalne fungovali.

free_albums bool Hovori, ci uzivatel potrebuje potvrdenie spravcu k tomu, aby v danon adresari mohol vytvorit nove album. Tento atribut nema vyznam, pokial GlobalSettings.Album.allow_user_albums vyzaduje potvrdenie pre kazde album.
wanted_count int Pocet uzivatelov, ktory nezavisle na sebe adresar navrhli. Tento atribut moze spravcom pomoct pri rozhodovani, ci je adresar skutocne ziadany.


Trieda: Album




name type description
owner link Uzivatel, ktory album vytvoril a je jeho vlastnikom.
directory link Adresar albumov, do ktoreho album patri.
icon link Hlavna fotka (ikona) albumu, zobrazujuca sa napriklad v adresaroch albumov. Moze to byt napriklad uputavka na dany album, alebo fotka reprezentujuca obsah albumu. Vid triedu Photo.
state enum Stav albumu. Moznosti:
  • waiting-approval - album caka (v adresari) na potvrdenie spravcom. Pristupne je iba jeho vlastnikovy.
  • approved - album je povolene, pristupne a zobrazovane v prehladoch albumov.
  • banned - album je v systeme zakazane. Pristupne je iba jeho vlastnikovy.
reason string Pokial je album v systeme zakazane, tento atribut moze obsahovat dovod jeho zakazania, napisany spravcom, ktory album zakazal. Inak atribut nema vyznam.
name string Nazov albumu. Toto meno sa zobrazuje v prehlade albumov adresaru ale aj ako titulok albumu. Meno albumu nemusi byt nijak unikatne a to ani v ramci daneho adresaru.
description text Popis albumu. Poznamka: Tento atribut ma obmedzenu maximalnu dlzku atributom GlobalSettings.Album.max_description_lenght.
skin enum Skin albumu. Jeden z moznych systemovych skinov. Vo farbach zvoleneho skinu sa zobrazuje cela prezentacna cast albumu, jeho fotky aj diskusia. Pokial vsak vlastnik albumu napriklad upravuje v albume fotky (tj. spravuje album), skin sa nepouziva.


Trieda: Album.Rules


name type description
free_visit bool Hovori, ci je album verejne pre navstevnikov a uzivatelov nepatriacich do priradenych skupin (vid triedu GroupInAlbum), alebo privatne. Privatne album mozu navstivit iba ludia zo skupin, ktore to maju explicitne povolene clenstvom v nejakej priradenej skupine. Vid triedu GroupInAlbum.

Poznamka: Toto opravnenie je nadradene ostatnym opravneniam tejto triedy. To znamena, ze pokial uzivatel nema pravo na vstup do albumu, ostatne prava (na fotky ci diskusie) su mu uplne zbytocne.

free_photo_contribution bool Hovori, ci mozu bezny uzivatelia pridavat do albumu fotky. Pokial nie, fotky mozu pridavat iba ludia zo skupin, ktore to maju explicitne povolene. Vid triedu GroupInAlbum.

Poznamka: Vid atribut free_visit vyssie.

photos_need_confirmation bool Hovori, ci musia byt vsetky pridavane fotky potvrdene aby mohli byt zobrazovane. Poznamka: Pokial ma uzivatel pravo v albume fotky potvrdzovat, neznamena to, ze sa nim pridavane fotky potvrdzovat nemusia. Taky uzivatel vsak moze pri pridavani fotiek explicitne potvrdit, aby prave pridavane fotky boli po pridani automaticky potvrdene. Toto potvrdenie musi urobit pri kazdom pridavani znovu.
photos_need_reconfirmation bool Hovori, ci musia byt zmenene fotky znovu schvalene aby mohli byt zobrazovane. Ako zmenena fotka sa napriklad berie fotka, ku ktorej bola do systemu nahrana jej nova verzia. Vid tiez atribut photos_need_confirmation.
public_discussion enum Hovori, ci je diskusia k albumu verejna a tiez ako velmi. Tento atribut prichadza v uvahu iba pokial uzivatel nepatri do ziadnej skupiny, ktora ma albume vyhodnejsie prava (vid triedu GroupInAlbum). Moznosti:
  • no - Verejna diskusia nie je vobec povolena a nezobrazuje sa. Diskusiu mozu pouzivat iba uzivatelia pripadnych priradenych skupin.
  • read-only - Diskusia je verejne pristupna na citanie. Pridavat prispevky vsak mozu iba uzivatelia pripadnych priradenych skupin.
  • moderated - Diskusia je verjene pristupna, prispevky od verejnosti vsak musia byt potvrdene, aby sa mohli zobrazovat.
  • full - Diskusia je volne otvorena aj pre verejnost.

Poznamka: Vid atribut free_visit vyssie.


Trieda: Album.Discussion


name type description
album link Album, ku ktoremu diskusia patri. Vid triedu Album.


Trieda: Album.Discussion.Item




name type description
discussion link Diskusia albumu, ku ktorej prispevok patri. Vid triedu Album.Discussion.
parent link Pokial je prispevok odpovedou na iny prispevok, atribut hovori, ktory prispevok to je.
state enum Stav prispevku. Moznosti:
  • waiting-approval - prispevok caka na potvrdenie.
  • approved - prispevok je potvrdeny a zobrazuje sa v diskusii albumu.
  • deleted - prispevok je zmazany. Pokial je nejaky prispevok uprosted diskusneho stromu a ine prispevky ho maju ako svoj parent, jeho zmazanim by celkovy strom odpovedi mohol zacat byt matuci. Preto miesto fyzickeho zmazania prispevku existuje moznost zmazania logickeho.
date datetime Datum a cas, kedy bol prispevok pridany.
user link Nepovinny odkaz na uzivatela, ktory prispevok pridal.. Pokial uzivatel po sebe nechce zanechat priamy odkaz na svoj profil, atribut je prazdny.
name string Zvolene meno uzivatela, ktory prispevok pridal. Toto meno nemusi byt zhodne s uzivatelovim User.Profile.display_name.
mail string Nepovinny mail na autora prispevku. Tento mail nemusi byt zhodne s uzivatelovim User.Profile.email_contact.
text text Text prispevku.
ip netip IP adresa, z ktorej bol prispevok pridany.
host string Hostname, z ktoreho bol prispevok pridany.


Trieda: PhotoInAlbum




name type description
state enum Stav fotky v albume. Moznosti:
  • waiting-approval - fotka caka na potvrdenie zobrazovania v albume.
  • approved - fotka je potvrdena a zobrazuje sa v albume. Vid tiez atribut added.
  • banned - fotka je v albume kompletne zakazana a nezobrazuje sa. Vid tiez atribut reason.
reason text Pokial je fotka v albume zakazana, tento atribut moze obsahovat dovod zakazania, ktory napisal napriklad uzivatel, ktory fotku zakazoval.
added datetime Datum a cas, kedy bola fotka v albume posledne povolena, resp modifikovana.. Poznamka: Ide o cas, kedy sa zacala zobrazovat jej posledna verzia, aby sa dalo urcit, ktore fotky su v albume nove. Pokial sa stav fotky meni zo zakazanej spat na povolenu, tento cas by sa nemal menit.


Trieda: GroupInAlbum


name type description
may_add_photo bool Opravnenie, ci smu uzivatelia priradenej skupiny pridavat do albumu fotky.
may_confirm_photo bool Opravnenie, ci smu uzivatelia priradenej skupiny potvrdzovat v albume pridane fotky.
may_suspend_photo bool Opravnenie, ci smu uzivatelia priradenej skupiny pozastavit zobrazovanie fotky (alebo jej komentarov) v albume.
may_delete_photo bool Opravnenie, ci smu uzivatelia priradenej skupiny mazat cudzie fotky v albume. Poznamka: Toto opravnenie nedava uzivatelovi moznost zmazat fotku zo systemu. Ma moznosti iba vyhodit ju z daneho albumu.
may_read_discussion bool Opravnenie, ci si smu uzivatelia priradenej skupiny prezerat diskusiu.

Poznamka: Toto opravnenie je nadradene opravneniam may_write_discussion, may_confirm_discussion a may_delete_discussion. To znamena, ze pokial uzivatel nema pravo na citanie, ostatne prava (na pisanie ci mazanie) su mu uplne zbytocne.

may_write_discussion bool Opravnenie, ci smu uzivatelia priradenej skupiny pridavat prispevky do diskusie k albumu.

Poznamka: Vid atribut may_read_discussion vyssie.

may_confirm_discussion bool Opravnenie, ci smu uzivatelia priradenej skupiny potvrdzovat prispevky v diskusii k albumu.

Poznamka: Vid atribut may_read_discussion vyssie.

may_delete_discussion bool Opravnenie, ci smu uzivatelia priradenej skupiny mazat prispevky v diskusii k albumu.

Poznamka: Vid atribut may_read_discussion vyssie.

may_manage_groups bool Opravnenie, ci smu uzivatelia priradenej skupiny spravovat skupiny priradene k albumu.

Poznamka: Uzivatel moze manipulovat iba s tymi pravami inych skupin, ktore ma sam cez nejaku skupinu povolene. T.j. pokial uzivatel nema pravo na mazanie fotiek v albume, nemoze toto pravo pridelit/vziat ziadnej skupine.

Poznamka: Uzivatel by nemal mat jednoduchu moznost zmenit prava tak, aby sam sebe zmenil prava. Napriklad by nemal mat moznost vziat nejakej skupine pravo mazat fotky, pokial je to posledna skupina vdaka ktorej ma on sam pravo mazat fotky. Pokial sa o to pokusi, system by ho mal aspon varovat.

may_modify_attributes bool Opravnenie, ci smu uzivatelia priradenej skupiny menit atributy albumu (meno, popis, atd.).


Trieda: FavouriteAlbum


name type description
last_photos_access datetime Cas, kedy dany uzivatel posledne navstivil album a videl jeho fotky. Tento atribut sluzi na zistenie, ci sa v albume nachadzaju nove fotky, odkedy posledne uzivatel album videl.
last_discussion_access datetime Cas, kedy dany uzivatel posledne navstivil diskusiu daneho albumu. Tento atribut sluzi na zistenie, ci sa v albume nachadzaju nove diskusne prispevky, odkedy posledne uzivatel diskusiu videl.