Powered by slightly modified MediaWiki and TED Notepad text editor.

Dev:Classes/Settings

Image:Classes_-_Settings.png

Navigation: Dev:Classes.

Contents

Uvod

Celosystemove nastavenia. Delia sa na viacero logickych casti:

  • Vseobecne systemove nastavenia, kde su hlavne tie nastavenia, ktore nepatria do inej skupiny alebo naopak patria do viacerych naraz.
  • Nastavenia pre navstevnikov, ktore zrhnaju to, ako sa ma system spravat k navstevnikom. Co im ma povolit a co naopak zakazat.
  • Nastavenia pre uzivatelov, ktore zhrnaju to, ako sa ma system spravat k uzivatelom.
  • Nastavenia pre fotky, ktore zhrnaju to, ako fotky v systeme funguju.
  • Nastavenia pre skupiny, ktore zhrnaju, co vsetko sa da so skupinami v systeme robit.
  • Nastavenia pre albumy, ktore zhrnaju, co vsetko sa da s albumami v systeme robit a na co vsetko sa daju albumy pouzit.
  • Nastavenia pre notifikacie, ktore zhrnaju, ako notifikacie v systeme funguju.

Nachadzaju sa tu tiez triedy popisujuce default hodnoty atributov niektorych novych tried, ako nopriklad novy navstevnik ci uzivatel, nove album ci skupina. Tieto default hodnoty sluzia na priame predvyplnenie atributov alebo predvyplnenie formularov.

Trieda: GlobalSettings

Vseobecne systemove nastavenia nepatriace ani do jednej z podkategorii. Dalsie nastavenia su kategorizovane ako nastavenia tykajuce sa bud uzivatelov (GlobalSettings.User), fotiek (GlobalSettings.Photo), skupin (GlobalSettings.Group), albumov (GlobalSettings.Album) alebo notifikacii (GlobalSettings.Notification).


name type description
captcha_length int Hovori, ci sa maju v systeme vyzadovat pri niektorych operaciach ciselne captcha obrazky. Medzi operacie patri napr. registracia uzivatela, posielanie mailu, priadavanie prispevku do diskusie, pridavanie komentaru, atd. Inymi slovami operacie, ktore mozu produkovat spam. Nulova hodnota znamena, ze chaptcha obrazky sa vyzadovat nebudu vobec. Kladna hodnota urcuje pocet cifier na obrazku. Vid tiez atribut User.AdminSettings.skip_captcha.
mangle_mails enum Hovori, ci sa maju mailove adresy pri zobrazovani kazit, aby ich spamovy roboti nemohli lahko precitat. Moznosti:
  • none
  • javascripted @
  • x [at] y
  • x --at-- y
  • x at y dot z
  • image of @
  • imaged
allow_html_tags enum Hovori, ci maju byt povolene HTML tagy v popisoch a inych, uzivatelmi zdanych textoch. Moznosti:
  • none - rusi v texte vsetky tagy a prevadza ich na plain-text zobrazenie.
  • some - zahrnuje zakladne formatovacie tagy, ako su napriklad b, i, u alebo br.
  • safe - zahrnuje temer vsetky formatovacie tagy, vcetne tabuliek. Tato skupina vsak neobsahuje ziadne linky ani skripty.
  • all - povoluje vsetky tagy, vcetne liniek, stylov a skriptov.
highlight_links bool Hovori, ci sa v textoch maju vyhladavat http, https a ftp linky. Pokial ano, najdene linky sa zlinkuju, to znamena, ze ich text bude klikatelny.


Trieda: GlobalSettings.Visitor

Celosystemove nastavenia tykajuce sa navstevnikov.


name type description
allow_free_registration bool Hovori, ci sa navstevnikovi zobrazi registracny formular a ci sa navstevnik moze sam zaregistrovat. Pokial nie, nove ucty bude moct vytvarat iba spravca systemu.
intro_message text Uvitacia sprava pre navstevnikov, zobrazujuca sa na uvodnej stranke navstevnika.


Trieda: GlobalSettings.Visitor.Default

 Abstraktna trieda predstavuje default nastavenia noveho navstevnika.

Poznamka: Default nastavenia registrovaneho uzivatela su v triede GlobalSettings.User.Default.


name type description
language enum Vid atribut Visitor.language.
skin enum Vid atribut Visitor.skin.
max_resolution enum Vid atribut Visitor.max_resolution.
comments_display_type enum Vid atribut Visitor.comments_display_type.
discussion_display_type enum Vid atribut Visitor.discussion_display_type.
typed_name string Vid atribut Visitor.typed_name.
typed_email string Vid atribut Visitor.typed_email.
album_list_style enum Vid atribut Visitor.album_list_style.
album_list_sort enum Vid atribut Visitor.album_list_sort.
album_list_pagelen int Vid atribut Visitor.album_list_pagelen.


Trieda: GlobalSettings.User

Celosystemove nastavenia tykajuce sa iba uzivatelov.


name type description
need_mail_confirmation bool Hovori, ci uzivatel musi potvrdit funkcnost zadanej mailovej adresy, napr. kliknutim na linku v potvrdzovacom maile.
need_account_confirmation bool Hovori, ci uzivatel musi pockat na potvrdenie registracie spravcom systemu.
mandatory_attributes set Zoznam atributov povinnych pri registracii. Uzivatel musi tieto atributy pri zmene svojich udajov nechat vyplnene.
min_password_length int Minimalna dlzka, ktoru musi mat kazde uzivatelove heslo.
max_description_length int Maximalna dlzka popisu uzivatela. Tato dlzka sa vztahuje na atribut User.Profile.description.
max_notes_length int Maximalna dlzka poznamok uzivatela k (ne)priatelovi. Tato dlzka sa vztahuje na atributy Friend.notes a Enemy.notes.
space_quota int Maximalny objem fotiek v bytoch, ktory moze jeden uzivatel vlozit do systemu. Pokial jeden uzivatel vlozi tu istu fotku viac krat (vlozene subory budu mat rovnake data a ulozia sa ako jeden Image), zapocita sa mu dana fotka len raz.
hide_sendmail enum Hovori, ci system umozni posielat maily priamo jednotlivym uzivatelom. Moznosti:
  • yes - nikto nema moznost posielat maily uzivatelom.
  • visitor-only - navstevnici nemaju moznost posielat maily uzivatelom.
  • no - vsetci maju moznost posielat maily uzivatelom.
hide_list_of_users enum Hovori, ci sa ma zrusit zobrazovanie kompletneho prehladu uzivatelov. Moznosti:
  • yes - nikto nema moznost prechadzat zoznamom uzivatelov.
  • visitor-only - navstevnici nemaju moznost prechadzat zoznamom uzivatelov.
  • no - vsetci maju moznost prechadzat zoznamom uzivatelov.
timeout_away int Hovori, kolko casu musi ubehnut od poslednej uzivatelovej akcie, aby sa uzivatel zobrazoval priatelom ako away. Nulova hodnota znamena ziaden timeout.
timeout_offline int Hovori, kolko casu musi ubehnut od poslednej uzivatelovej akcie, aby sa uzivatel zobrazoval priatelom ako offline. Offline uzivatel nemusi byt nutne odhlaseny, staci ak je dlhsie necinny. Naopak, odhlaseny uzivatel je offline vzdy. Nulova hodnota znamena ziaden timeout.
timeout_logout int Hovori, kolko casu musi ubehnut od poslednej uzivatelovej akcie, aby bol uzivatel automaticky odhlaseny. Nulova hodnota znamena ziaden timeout.
intro_message text Uvitacia sprava pre uzivatelov, zobrazujuca sa na uvodnej stranke uzivatela.


Trieda: GlobalSettings.User.Default

 Abstraktna trieda predstavuje default nastavenia noveho uzivatela.

Poznamka: Default nastavenia registrovaneho uzivatela, ktore su sucastou triedy Visitor su v triede GlobalSettings.Visitor.Default.


name type description
show_email_contact bool Vid atribut User.Profile.show_email_contact.
show_web bool Vid atribut User.Profile.show_web.
show_icq bool Vid atribut User.Profile.show_icq.
show_birth bool Vid atribut User.Profile.show_birth.
show_sex bool Vid atribut User.Profile.show_sex.
show_address bool Vid atribut User.Profile.show_address.
show_description bool Vid atribut User.Profile.show_description.
show_telephone bool Vid atribut User.Profile.show_telephone.
common_notifications set Vid atribut User.Settings.common_notifications.
notifications_frequency enum Vid atribut User.Settings.notifications_frequency.
user_mails_frequency enum Vid atribut User.Settings.user_mails_frequency.
hidden_objects set Vid atribut User.Settings.hidden_objects.
want_confirm_comments bool Vid atribut User.Settings.want_confirm_comments.
photo_list_style enum Vid atribut Visitor.Settings.photo_list_style.
photo_list_sort enum Vid atribut Visitor.Settings.photo_list_sort.
photo_list_pagelen int Vid atribut Visitor.Settings.photo_list_pagelen.
skip_captcha bool Vid atribut User.AdminSettings.skip_captcha.
override_space_quota int Vid atribut User.AdminSettings.override_space_quota.
full_read_access bool Vid atribut User.AdminSettings.full_read_access.
may_manage_users bool Vid atribut User.AdminSettings.may_manage_users.
may_manage_photos bool Vid atribut User.AdminSettings.may_manage_photos.
may_manage_categories bool Vid atribut User.AdminSettings.may_manage_categories.
may_manage_groups bool Vid atribut User.AdminSettings.may_manage_groups.
may_manage_directories bool Vid atribut User.AdminSettings.may_manage_directories.
may_manage_albums bool Vid atribut User.AdminSettings.may_manage_albums.
may_manage_settings bool Vid atribut User.AdminSettings.may_manage_settings.


Trieda: GlobalSettings.Photo

 Celosystemove nastavenia tykajuce sa iba fotiek a ulozista.


name type description
hide_all_photos bool Hovori, ci maju byt v systeme fotky skryte. Pokial ano, cela existencia ulozista fotiek je nepristupna.
max_description_length int Maximalna povolena dlzka popisu fotky. Tato dlzka sa vztahuje na atribut Photo.Info.description.
allow_user_watermark bool Hovori, ci si koncovy uzivatel smie definovat vlastny watermark. Pokial nie, atributy User.Settings.watermark_position, User.Settings.watermark_image a Photo.Info.watermark_disabled sa vobec nepouzivaju.

Algoritmus na vyber obrazku a jeho pozicie by mal vypadat asi takto: 

if (GlobalSettings.Photo.allow_user_watermark == true)
{
  if (Photo.Info.watermark_disabled)
  {
    position = none;
  }
  else
  {
    if (User.Settings.watermark_image == NULL)
      watermark = GlobalSettings.Photo.default_watermark_image
    else
      watermark = User.Settings.watermark_image;

    if (User.Settings.watermark_position == default)
      position = GlobalSettings.Photo.default_watermark_position
    else
      position = User.Settings.watermark_position;
  }
}
else
{
  watermark = GlobalSettings.Photo.default_watermark_image
  position = GlobalSettings.Photo.default_watermark_position
}
default_watermark_position struct Hovori, kam sa ma na uzivatelsku fotku pripadny watermark nalepit. Moznosti: none, top-left, top-right, top-center, atd. Tento atribut sa pouziva iba pokial uzivatel nema definovany vlastny User.Settings.watermark_position (hodnota default) alebo pokial mu to zakazuje atribut allow_user_watermark. Vid vyssie.
default_watermark_image image Hovori, cim maju byt watermarkovane uzivatelske fotky. Tento atribut sa pouziva iba pokial uzivatel nema definovany vlastny User.Settings.watermark_image alebo pokial mu to zakazuje atribut allow_user_watermark. Vid vyssie.
max_datasize int Hovori, aka moze byt maximalna velkost jednej uzivatelskej fotky v bytoch.
max_resolution int Hovori, aky moze byt maximalny rozmer jednej uzivatelskej fotky (bud vertikalny alebo horizontalny) v pixeloch.
hide_comments enum Hovori, ako a komu sa maju zobrazovat komentare k fotkam. Moznosti:
  • yes - skryje komentare uplne.
  • visitor-only - skryje komentare navstevnikom, tj. zobrazi ich iba uzivatelom.
  • write-for-visitor - skryje moznost pridavania komentarov navstevnikom, ale zobrazi ich kazdemu.
  • no - zobrazi komentare vsetkym aj s moznostou pridavat.
max_comment_length int Maximalna povolena dlzka komentaru fotky. Tato dlzka sa vztahuje na atribut PhotoComment.text v triede PhotoComment.
hide_score enum Hovori, ako a komu sa ma zobrazovat hodnotenie fotky. Moznosti:
  • yes - skryje hodnotenia uplne.
  • visitor-only - skryje hodnotenia navstevnikom, tj. zobrazi ich iba uzivatelom.
  • write-for-visitor - skryje moznost hodnotenia navstevnikom, ale zobrazi ich kazdemu.
  • no - zobrazi hodnotenia vsetkym aj s moznostou hodnotit.
min_score_count int Hovori, kolko krat musi byt fotka minimalne hodnotena, aby sa zobrazovalo jej hodnotenie. Nekladna hodnota (kupodivu) znamena, ze sa hodnotenie moze zobrazovat hned po prvom hodnoteni.
hide_counter enum Hovori, ako a komu sa ma zobrazovat pocitadlo pristupov. Moznosti:
  • yes - skryje pocitadla uplne.
  • visitor-only - skryje pocitadla navstevnikom, tj. zobrazi ich iba uzivatelom.
  • no - zobrazi pocitadla vsetkym.

Poznamka: Aj ked sa pocitadlo nezobrazuje alebo zobrazuje iba uzivatelom (moznosti yes a visitors only), zapocitava sa vzdy kazdy pristup, tj. aj pristup navstevnika.

trash_tag_name string Nazov tagu predstavujuceho systemovy kos. Kazda fotka s takymto tagom je v kosi a nezobrazuje sa v ziadnych albumoch.
shared_storage_for_visitors enum Hovori, ci a ako smu navstevnici zasahovat do verejneho uloziska fotiek. Moznosti:
  • none - navstevnici nemaju moznost prezerat verejne fotky, fotky sa im vsak stale mozu zobrazit napriklad ako ikonky adresarov.
  • read - navstevnici maju moznost prezerat a komentovat verejne fotky, nemaju vsak moznost ich upravovat ci pridavat.
  • add - navstevnici maju moznost prezerat a komentovat verejne fotky a tiez pridavat nove fotky ci upravovat atributy starych.
  • full - navstevnici maju moznost nielen prezerat a pridavat, ale i mazat verejne fotky.

Poznamka: Moznost nahrat novu verziu fotky do verejnych fotiek maju navstevnici iba pokial maju zaroven moznost mazat. Nahratim novej verzie sa totiz zmaze ta stara.

Poznamka: Vid tiez atribut GlobalSettings.Photo.shared_storage_for_users.

shared_storage_for_users enum Hovori, ci a ako smu uzivatelia zasahovat do verejneho uloziska fotiek. Moznosti:
  • none - nikto nema moznost prezerat verejne fotky, stale sa vsak mozu zobrazit napriklad ako ikonky adresarov, pokial niekde zostali este nastavene.
  • admin-only - verejne fotky su pristupne iba pre uzivatelov s opravnenim User.AdminSettings.may_manage_shared_storage.
  • read - verejne fotky su pristupne vsetkym uzivatelom, pridavat, upravovat ci mazat vsak mozu iba uzivatelia s opravnenim User.AdminSettings.may_manage_shared_storage.
  • add - verejne fotky su pristupne vsetkym uzivatelom a mozu do nich aj pridavat nove fotky ci upravovat atributy starych. Mazat vsak mozu iba uzivatelia s opravnenim User.AdminSettings.may_manage_shared_storage.
  • full - vsetci uzivatelia maju moznost manipulovat s verejnymi fotkami ako so svojimi vlastnymi.

Poznamka: Moznost nahrat novu verziou fotky maju vzdy iba ti uzivatelia, ktori maju zaroven moznost mazat. Nahratim novej verzie sa totiz zmaze ta stara.

Poznamka: Tento atribut je doplnkom atributu GlobalSettings.Photo.shared_storage_for_visitors. Nema vyznam zakazovat prihlasenym uzivatelom verejne fotky, pokial ich maju navstevnici povolene.


Trieda: GlobalSettings.Photo.Default

Abstraktna trieda predstavuje default nastavenia novej fotky.

Poznamka: Aktualne neexistuju ziadne default nastavenia pre novu fotku. Nejake vsak mozu casom pribudnut.


Trieda: GlobalSettings.Group

Celosystemove nastavenia tykajuce sa iba skupin.


name type description
hide_all_groups enum Hovori, ci maju byt v systeme skryte skupiny. Moznosti:
  • yes - cela existencia skupin je skryta.
  • visitor-only - existencia skupin je viditelna iba registrovanym uzivatelom.
  • no - existencia skupin je viditelna pre vsetkych.
allow_user_groups enum Hovori, ci si bezny uzivatel moze zalozit vlastnu skupinu. Moznosti:
  • yes - povoli volne zalozenie skupiny. Tato moznost je menej prioritna nez atribut GroupCategory.free_contribution.
  • need-confirmation - nove skupiny vyzaduju potvrdenie spravcom, bezny uzivatel musi pockat na jeho potvrdenie. Tato moznost je vzdy prioritnejsia nez atribut GroupCategory.free_contribution.
  • no - povoli zakladanie skupin iba spravcom systemu (ktory mozu potvrdzovat skupiny). Tato moznost je prioritnejsia, nez GroupCategory.free_contribution.
allow_user_categories enum New. Hovori, ci bezny uzivatel moze zalozit vlastny adresar albumov. Moznosti:
  • yes - povoli volne zakladanie.
  • suggest - umozni navrhovanie uzivatelmi.
  • no - povoli iba spravcom systemu.
max_description_length int Maximalna dlzka popisu skupiny. Tato dlzka sa vztahuje na atribut Group.description.
hide_discussion enum Hovori, ako a komu sa maju zobrazovat on-line diskusie skupin. Moznosti:
  • yes - skryje diskusie uplne.
  • visitor-only - skryje diskusie navstevnikom, tj. zobrazi ich iba uzivatelom.
  • write-for-visitor - skryje moznost pridavania prispevkov navstevnikom, ale zobrazi diskusie kazdemu.
  • no - zobrazi diskusie vsetkym aj s moznostou pridavat prispevky.
max_discussion_item_length int New. Maximalna dlzka prispevku v diskusii skupiny. Tato dlzka sa vztahuje na atribut Group.Discussion.Item.text.
hide_list_of_groups enum Hovori, ci sa ma zrusit zobrazovanie prehladu skupin. Moznosti:
  • yes - nikto nema moznost prechadzat kompletnym zoznamom skupin.
  • visitor-only - navstevnici nemaju moznost prechadzat kompletnym zoznamom skupin.
  • no - vsetci maju moznost prechadzat kompletnym zoznamom skupin.


Trieda: GlobalSettings.Group.Default

 Abstraktna trieda predstavuje default nastavenia novej skupiny.


name type description
free_join bool Vid atribut Group.Rules.free_join.
public_discussion enum Vid atribut Group.Rules.public_discussion.
private_discussion enum Vid atribut Group.Rules.private_discussion.


Trieda: GlobalSettings.Album

Celosystemove nastavenia tykajuce sa iba albumov.


name type description
hide_all_albums bool Hovori, ci maju byt v systeme skryte albumy. Pokial ano, cela existencia albumov je nepristupna.

Poznamka: Pokial su v systeme albumy skryte, adresare albumov nemaju ziaden vyznam a nezobrazuju sa ani tie.

allow_user_albums enum Hovori, ci si bezny uzivatel moze vytvorit vlastne album. Moznosti:
  • yes - povoli volne vytvoranie albumov.
  • need-confirmation - nove albumy vyzaduju potvrdenie spravcom, bezny uzivatel musi pockat na jeho potvrdenie.
  • no - povoli vytvaranie iba spravcom systemu (ktory mozu potvrdzovat albumy).
max_description_length int Maximalna dlzka popisu albumu alebo adresaru albumov. Tato dlzka sa vztahuje na atributy Album.description a AlbumDirectory.description.
allow_user_directories enum Hovori, ci bezny uzivatel moze zalozit vlastny adresar albumov. Moznosti:
  • yes - povoli volne zakladanie.
  • suggest - umozni navrhovanie uzivatelmi.
  • no - povoli iba spravcom systemu.
hide_discussion enum Hovori, ako a komu sa maju zobrazovat on-line diskusie k albumom. Moznosti:
  • yes - skryje diskusie uplne.
  • visitor-only - skryje diskusie navstevnikom, tj. zobrazi ich iba uzivatelom.
  • write-for-visitor - skryje moznost pridavania prispevkov navstevnikom, ale zobrazi diskusie kazdemu.
  • no - zobrazi diskusie vsetkym aj s moznostou pridavat prispevky.
max_discussion_item_length int Maximalna dlzka prispevku v diskusii albumu. Tato dlzka sa vztahuje na atribut Album.Discussion.Item.text.


Trieda: GlobalSettings.Album.Default

 Abstraktna trieda predstavuje default nastavenia noveho albumu.


name type description
icon link Vid atribut Album.icon.
skin enum Vid atribut Album.skin.
free_visit bool Vid atribut Album.Rules.free_visit.
free_photo_contribution enum Vid atribut Album.Rules.free_photo_contribution.
photos_need_confirmation bool Vid atribut Album.Rules.photos_need_confirmation.
photos_need_reconfirmation bool Vid atribut Album.Rules.photos_need_reconfirmation.
public_discussion enum Vid atribut Album.Rules.public_discussion.


Trieda: GlobalSettings.Notification

Celosystemove nastavenia tykajuce sa iba notifikacii.


name type description
hide_all_notifications bool Hovori, ci sa notifikacie maju v systeme pouzivat.


Trieda: GlobalSettings.Notification.Default

Abstraktna trieda predstavuje default nastavenia novej notifikacie.

Poznamka: Aktualne neexistuju ziadne default nastavenia pre novu notifikaciu. Nejake vsak mozu casom pribudnut.