Dokumentacja 2014 Systemu Zarządzania Treścią YellowCMS

Transkrypt

1 Dkumentacja 2014 Systemu Zarządzania Treścią YellwCMS data: sierpień 2014 wersja: 1.0 YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

2 Struktura katalgów CMS - wcześniej używan katalgu cms/, ale becnie stsujemy inne, trudniejsze d zgadnięcia - np. kkpit/ czy panel/ /ckeditr/ - katalg ckeditra. W zasadzie przegrywa się g całeg i nic w nim nie zmienia. Jedyny plik, w którym czasem mże być cś d rbty t: /cnfig.js - tam są przede wszystkim ustawiane przyciski dla pszczególnych tlbarów. /ckfinder/ - katalg ckfindera. Pdbnie, nic się w tym nie zmienia, czasem (gdy cś nie działa) t zaglądamy d /cnfig.php główne ustawienie d sprawdzenia t katalg zapisu plików. /cnfig/ - katalg z cnfigiem dla prjektu. Więcej infrmacji: tutaj Dla każdeg nweg prjektu niezbędne jest dknanie ustawień w tych plikach. /imgs/ - katalg z grafiką d CMSa. Zawiera pdkatalgi: /utils/ - grafiki dla zewnętrznych elementów (ddatków JSwych, ect.) /ikny/ - zbiór kluczwych ikn dla cmsa w rzmiarach 16x16, 30x30 i 52x52 /iknki/ - iknki dla różnych rzszerzeń plików /flagi/ - flagi dla różnych wersji językwych. Pwinny mieć takie same nazwy jak języki w /cnfig/cnfig.php. Flagi mają rzmiar 24x16px. Ddatkw twrzy się flagi szare nazwie "x-grey.gif" pprzez ustawienie Hues/Saturatin na: saturatin -50, ligthness +30. Brdery dla flag są: #111111, a szarych #aaaaaa /js/ - zbiór plików JS dla CMSa. Główny plik CMSa t ut.js, ale burdel w nim jest straszny. /mduly/ - katalg z głównymi plikami CMSa. Więcej infrmacji: tutaj /templates/ - katalg z template'ami CMSa. Zawiera pdkatalgi: /templates/ - katalg z plikami. Jest tam dść duży bałagan, ale w większści przypadków d nieg się nawet nie zagląda. /templates_c/ - katalg d któreg będą zapisywane skmpilwane pliki. Ważne - musi mieć prawa dstępu 777. Czasem jakby zmiany w plikach tpl nie przynsiły rezultatów należy wyczyścić na serwerze ten katalg, ale dść dawn się tak nie dział (zależne d różnych serwerów). ddatkw w katalgu z CMSem znajdują się pliki: /.htaccess - plik htaccess - nic się w nim nie zmienia. /ajax.php - plik ajaxa - nic się w nim nie zmienia. /cms.css - plik z cssami. Raczej nic się tam nie zmienia, czasem ddaje się flagę lub nwe iknki np. d spisu w CMS. /delete.php - plik kasujący dmyślneg użytkwnika raz plik install.php. Dawn nie testwany, lepiej rbić ręcznie. /index.php - główny plik CMSa. Nic się w nim nie zmienia. Na górze, w kmentarzu znajduje się numer wersji CMSa (d sprawdzenia w changelgu). /install.php - główny plik instalacyjny CMSa. Więcej infrmacji: tutaj /maintenance.php - pmcniczy plik d CMSa. Pzwala wyknać pewne funkcje, np. d masweg skalwania zdjęć, ect. Jest zabezpieczny przed niepżądanym użyciem przez wykrzystanie funkcji devtls::testuj() /pht.php - plik wyświetlający zdjęcia w CMSie - nic się w nim nie zmienia. /wrds.php - plik zbierający słwa d tłumaczenia. Żeby działał należy ustawić flagę w cnfig/settings.php: cnfig::ddaj('cmslang_zbieraj',1); i przeklikać całeg CMSa żeby uzyskać listę wyrażeń d tłumaczenia. Dawn nie stswany. YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

3 Katalg Cnfig Katalg cnfig zawiera pszczególne pliki: /cnfig.php - zawiera ustawienia CMSa. Najważniejsze rzeczy t: $www - pełny adres strny z kńcwym slashem, np.' $panel - wcześniej katalg panelu, becnie mżna mu przypisać zmienną statyczną KATALOG $resurcesflder - katalg ze zdjęciami, zalecana wartść t 'resurces' cnfig::ddaj('nazwa_prjektu','wartsc'); - w miejsce wartści należy wpisać przedrstek d tabel w bazie danych. Zazwyczaj jakaś krótka nazwa prjektu, np. 'dem' cnfig::ddaj('nazwa_prjektu_banner','wartsc'); - w miejsce wartści należy wpisać nazwę prjektu, która będzie wyświetlana w bannerze górnym. cnfig::ddaj('strna_cms_title','wartsc'); - w miejsce wartści należy wpisać meta tytuł panelu CMS Klejna sekcja jest raczej niezmienialna, a przypisująca ścieżki d pszczególnych katalgów Sekcja swfuplad tu również nie zmieniać nic na kńcu znajduje się sekcja z językami na strnie. Każdy język jest ddawany za pmcą instrukcji: lang::ddaj('nazwa','skrót'); - przy czym skrót jest t dwuliterwy skrót daneg języka, np. 'nl', 'en', 'pl'. Ważne - skrót jest pwiązany z plem w bazie danych raz z nazwami plików iknek flag dla pszczególnych języków, dlateg wart używać standardwych skrótów. Obecnie wykrzystywane skróty t: 'si','pl','nl','fr','en','de','cz'. prjekt musi psiadać zdefiniwany c najmniej jeden język. Np. lang::ddaj('plski','pl'); /database.php - zawiera ustawienia dstępu d bazy danych, czyli: hst, user, hasł i baza. Ddatkw ustawia się tu kdwanie, ale wysce zalecane jest zstawienie tutaj UTF-8 /lang.php - zawiera języki dla CMSa (czyli jakie tłumaczenie zdań w CMS). Nie mylić z językami prjektu! Język CMSa t nic inneg jak tylk język, w którym będą wyświetlane nazwy pól i instrukcje - jest n wybierany pdczas lgwania i później nie mże być zmieniny. Języki prjektu t języki w których będą przechwywane w bazie danych. Przykład: prjekt psiadający dwa języki "de" i "en" raz dwa języki CMSa: "pl" i "en". Przy lgwaniu użytkwnik wybiera w jakim języku chce glądać panel - wybierze "pl" t będzie miał teksty p plsku. Ale przez t że są dwa języki prjektu t np. w bazie danych w tabeli z meta tagami będą dwa rekrdy - jeden z plem "lang" ustawinym na "de" i drugi z "en". Języki definiuje siępprzez ustawienie wpierw w tym pliku tablicy np.: $langs = array('pl'=>'plski', 'en'=>'angielski'); Czyli klucz=>nazwa wyświetlana języka. Dmyślnym językiem jest pl. WAŻNE!! Następnym krkiem dla tłumaczeń jest utwrzenie plików tłumaczeń CMS w katalgu głównym panelu w katalgu /translates Każdy jęsyk ma sbny plik i musi mieć nazwę np. translate_en.txt. Plski język jest dmyślny nie trzeba twrzyć dla nieg pliku. Spsób tłumaczenia w pliku: YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

4 - Każdy wyraz lub zdanie d przetłumaczenia rzpczyna się d nwej linijki pprzez klawisz [Enter], także zdania nie mgą zawierać enterów!!! - Składnia tłumaczenia: plski wyraz lub zdanie, wyraz lub zdanie przetłumacne Apstrfy, które napisane pwyżej muszą się znaleźć i bk przecinka nie mże być spacji!!!!! Tłumaczenia są dsłwne i każdy znak ma znaczenie! Wielkść liter również. Prjekt pwinien mieć zdefiniwnay c najmniej jeden język CMSa Nie ma mżliwści wyłączenia tłumaczeń dla jakiegś języka inneg niż zakmentwanie (lub skaswanie) wszystkich wyrażeń tłumacznych dla nieg /panel_menu.php - zawiera układ menu dla CMSa. Wart stswać w tym pliku wcięcia. Nie jest t knieczne dla prjektu, ale bardz pprawia czytelnść. Klejne pdmenu t klejne wcięcie. Maksymalna ilść pzimów t 3. Menu ddaje się w/g instrukcji: ddaj($nazwa,$mdul_rdzaj='',$mdul_nazwa='',$pzim=0,$nazwa_menu=- 1,$menu_brazek='', $widczny = 1), gdzie: $nazwa - nazwa w Menu $mdul_rdzaj - nazwa pliku klasy zawierająceg definicję mdułu $mdul_nazwa - wartść, która będzie przechwywana plu "mdul" w bazie danych. Zazwyczaj jeden typ elementów (np. newsy) psiada unikalny zestaw klasy raz mdułu, ale są sytuacje, gdzie więcej typów elementów psiada takie same pla (np. mamy kilka stałych pdstrn tekstwych: nas, ferta, plecamy, które mają takie same pla w bazie danych) - w tym wypadku będzie je definiwała ta sama klasa, ale będą się różniły wartścią pla "mdul" w bazie danych. $nazwa_menu - pzstałść p dawnym CMSie. Chdził t, żeby przypisać pewnym elementm stałe klucze. Obecnie nieptrzebne. $menu_brazek - ścieżka d pliku ikny daneg menu. Dawn niewykrzystywane, prawdpdbnie nie działa. $widczny - jeżeli ustawi się na 0 t element będzie ddawany d menu, ale nie będzie w nim widczny (będzie w tablicy z menu, ale nie będzie się pjawiał w widku). Bardz rzadk wykrzystywane - zazwyczaj gdy pewien element nie mże występwać jak cś sbneg, a jedynie jak pdelement inneg. Obecnie zastąpine przez funkcję mdul::pdmduł innymi słwy najczęściej sptykane pcje t: ddaj($nazwa) - pdkatalg pzimu 0, ddaj($nazwa,'','',$pzim) - pdkatalg pzimów wyższych raz ddaj($nazwa,$klasa,$mdul,$pzim) - właściwy element menu WAŻNE!!! Gdy dany mduł nie zstał ddany d d teg menu nie będzie n zainstalwany (tablica w bazie nie zstanie utwrzna). Dlateg p każdrazwej zmianie teg menu knieczne jest uruchmienie pnwnie pliku instalki CMS install.php. /settings.php - zawiera inne ustawienia CMSa. W zasadzie t nie zmienia się tam nic. Ewentualnie gdy w CMSie chce się włączyć ddatkwe pliki js, czy css t tam się t rbi, ale pza tym lepiej nic nie ruszać. Katalg Mduły Katalg /mduly/ zawiera najważniejsze pliki dla CMSa. Składa się z: YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

5 /funkcje/ - pzstałść p dawnym CMSie. Obecnie w zasadzie nie używany. /jadr/ - jądr systemu. Opisane tutaj /mduly/ - katalg z klasami pisującymi strukturę systemu. W zasadzie jest t warstwa Mdelu w MVC. Opisane tutaj /pla/ - katalg z różnymi typami pól używanymi w CMSie. Opisane tutaj /smarty/ - jądr smartów. Nie zmienia się w nim nic. Używana wersja Smarty t 2.0. Dkumentacja dstępna jest na Plecam zapznać się przede wszystkim z rzdziałami: 4. Variables, 5. Variable Mdifiers, 7. Built-in Functins raz wybranymi funckami rzdziału 8. Custm Functins /utilities/ - katalg z różnymi użytecznymi klasami. Opisane tutaj Katalg Mduły/Jądr/ Katalg /mduly/jadr/ zawiera jądr systemu. W zasadzie nie pwinn się w nim nic zmieniać pmiędzy prjektami. Pza czywiście zmianami w CMSie, naprawianiem błędów raz ddawaniem nwych funkcji. Katalg Mduły/Mduły/ Katalg /mduly/mduly/ zawiera klasy pisujące system. Ta niefrtunna nazwa mże czasem wprwadzać zamęt, ale jak się zapamięta że mduł=klasa t już jest łatwiej. W chwili becnej są dstępne następujące typy mdułów: strna - typ dla pjedynczeg elementu (czyli psiadający dkładnie jeden rekrd w bazie danych) - wykrzystywany d przechwywania wszelkich ustawień, ect. P twarciu klasy teg typu w menu pjawia się d razu strna edycji. Przykład jest tutaj (ddatkw w pliku jest przykład wszystkich pól) spis - typ dla listy elementów (czyli psiadający d zera d nieskńcznej liczby rekrdów w bazie danych) - wykrzystywany d przechwywania wszelkich list, typu: newsy, użytkwnicy, ect. P twarciu klasy teg typu w menu pjawia się na pczątku lista elementów, a następnie w zależnści d ustawień mżna edytwać istniejące lub ddawać nwe. Przykład jest tutaj katalg - typ dla listy elementów (czyli psiadający d zera d nieskńcznej liczby rekrdów w bazie danych) psiadających ddatkw wiele pzimów (czyli rekrdy mgą być zagniedżne w innych rekrdach jak ich dzieci) - wykrzystywany d przechwywania wszelkich różnpzimwych list, typu kategrie, ect. Ddatkw mżna ddać elemnty jak typu: "plik" lub "flder". Elementy typu flder w przeciwieństwie d tych typu plik mga być rdzicami i psiadać w sbie inne rekrdy. Pnadt elementy typu flder raz plik mgą psiadać różne pla w bazie danych (pdbnie jak różne pzimy mga psiadac różne pla, czyli np. flder na pzimie 0 mże mieć inne pla niż flder na pzimie 1), ale t jest nieefektywne, gdyż pwduje znaczący rzrst tabeli w bazie danych. Mżna ddatkw ustawić maksymalny pzim (ale i tak mżna t bejść - wystarczy przenieść flder z dziećmi na inny pzim). Pprzez fakt, że na liście elemntów są elementy z różnych pzimów t w tym typie klasy przesuwanie klejnści jest mżliwe jedynie pprzez strzałki. Przykład jest tutaj W klasie pisującej mduł mżna wykrzystać następujące metdy (w nawiasach kwadratwych typy klas: P = strna, L = spis, C = katalg) YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

6 Ustawienia glbalne: ddaj($nazwa) [PLC] - ddaje mduł. Metda wymagana, jak jedna z pierwszych. Nazwa musi byc taka sama jak nazwa klasy. ddaj_help($help) [PLC] - mżna ddać infrmację na temat mdułu (c rbi, ect.). Przy typie "strna" infrmacja jest wyświetlana na górze przy edycji, przy pzstałych jest wyświetlana pnad listą elementów. Mżna używać HTMLa. ddaj_where($where) [PLC] - pcjnalny warunek WHERE d zapytania, gdy mduł ma pbierać tylk niektóre elementy (np. widczne tylk dla jakiegś klienta, ect.) lang($bl) [PLC] - mżna ustawić na 0 gdy mduł ma być niezależny d języka (np. zamówienia, użytkwnicy panelu, ect.) tablica($tablica,$numer='-1') [PLC] - nazwa tabeli w bazie z której ma pbierać. Metda niestety wymagana. Gdy twrzy się mduły nie parte na bazie danych (np. statystyki, ect.) t trzeba tu napisać jakąś tabelę, która na pewn będzie (np. system_uzytkwnicy). Niby mżna ddać więcej tablic, ale nie jest t zalecane, b nie był testwane! typ($typ) [PLC] - ustawia typ mdułu. Dstępne pcje: "spis/strna/katalg". Metda wymagana. Ustawienia spisów: AddNewName($name) [LC] - pzwala kreślić treść napisu wyświetlaneg pd buttnem d ddawania nwych rekrdów. Dmyślnie: Ddaj nwy aktywne($aktywne,$true='',$false='') [LC] - dmyślnie "fajeczka" przy rekrdzie na liście zmienia ple "aktywne" w bazie, ale mżna zmienić na inne ple, które przyjmuje wartści 1/0. $aktywne - nazwa pla, $true - treść gdy wartść jest równa 1, $false - treść gdy wartść 0. ddaj_extended_inf($inf) [LC] - ddanie rzwijaneg pla z infrmacjami dla każdeg rekrdu. Mże być html. Inf: tutaj ddaj_iknke($plik,$warunek,$pis='') [LC] - Ddaje nam na spisie iknkę w przypadku spełnienia $warunku (nrmalneg, evalwaneg przez PHPa) a także wyświetla $pis p najechaniu. Example: mdul::ddaj_iknke('imgs/specific/exclamatin-redframe.png','{mzliwe_d_wylswania}=="0"',cmslang::wrd('błędne')); ddaj_kategrie($nazwa,$kategria) [LC] - ddaje mżliwśc filtrwania wyświetlanych wyników (ddaje warunek WHERE d zapytania SQL). Example: mdul::ddaj_kategrie('błędne',"mzliwe_d_wylswania = '0'"); ddaj_rder($rder,$nazwa) [LC] - kreśla spsób srtwania listy wyników. Metda wymagana. Mżna ddać więcej niż jedn srtwanie. Jak elementy mają psiadać mżliwść srtwania według admina t pierwsze srtwanie pwinn być takie nastepujące: mdul::ddaj_rder('klejnść DESC',cmslang::wrd('Według strzałek')); ddaj_pdmdul($pdmdul,$ikna='',$napis='',$pis='') [LC] - ddawanie pdmdułu d mdułu - jest t alternatywa d stswania typu mdul2, który ma graniczenia (brak zakładek, srtwania, wyszukiwartki, ect). Klasa ptmka t $pdmdul, $ikna t ścieżka d ikny, $napis t napis pjawiający się p najechaniu na iknę a $pis t pis wyświetlający się w spisie knkretneg elementu (mże zawierać dane z tabeli teg elementu). Example: mdul::ddaj_pdmdul('fields','imgs/specific/e.png','fields','fields in attribute set: "{name}"');. Inf: najczęściej jest wykrzystywany d twrzenia spisu w spisie, YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

7 pdmduły są autmatycznie instalwane, prawa dstępu d pdmdułu są dziedziczne z rdzica, pdmduł nie musi być ddawany d panel_menu.php ddaj_przycisk($nazwa,$funkcja,$zewnetrzny=0,$ikna='',$alert='') [LC] - ddaje przycisk d każdeg elementu nazwie $nazwa, dpalający funkcję nazwie $funkcja będącą zdefiniwaną w mdule (wyknywaną przez PHPa) lub w pliku JS i wyknywaną przez JavaScript (gdy zmienna $zewnetrzny==1). Pnadt funkcja ta mże psiadać iknkę ścieżce zdefiniwaną w $ikna raz psiadać alert JSwy wyświetlający się przed jej wyknaniem treści $alert. Example: mdul::ddaj_przycisk('kreacje','kreacje');. W funkcji ID elementu będzie dstępny przez get::utwrz()->get('numer') ddaj_przycisk_glbalny($nazwa,$funkcja,$zewnetrzny=0,$ikna='',$alert='') [LC] - pdbnie jak metda pwyżej, ale ddaje jeden przycisk glbalny a nie przycisk d każdeg rekrdu. Przydatne gdy trzeba prewać na całej klasie, a nie tylk na jednym rekrdzie. ddaj_spis($spis) [LC] - kreśla c będzie wyświetlane na liście elementów. Jest ucinane d 100 znaków, więc nie pwinn być długie. Wszystk c pwyżej należy dać d extended_inf Inf: tutaj ddaj_szukaj($szukaj) [LC] - lista pól p których ma działać wyszukiwarka. Mże być więcej niż jedn, ale każde pwinn być ddawane sbn. Warunki są ddzielane "OR". Example: mdul::ddaj_szukaj('nazwa'); ilsc($ilsc) [LC] - integer kreślający ile ma być dmyślnie wyświetlanych elementów na liście. Dmyślnie 50. W przypadku dużej liczby małych rekrdów mżna zwiększyć, gdy rekrdy pbierają dane z kilku tabel wypada zmniejszyć. klejnsc_dwrtna($klejnsc) [LC] - przy ddawaniu elementu najnwszy ma ple "kklejnsc" ustawiane zawsze na największą wartść. Ale dmyślnie strzałki działają tak, że ustawia w klejnści rsnącej, czyli najwyżej są wyświetlane elmenty najniższej klejnści. Dlateg gdy najświeższy element ma być wyświetlany na samej górze należy wywłać tą metdę z argumentem 1. Pnadt wtedy też należy dać pierwszy rder taki jak jest w jeg pisie (żeby zmiana klejnści była widczna zarówn na strnie jak i w panelu. pkaz_klejnsc($klejnsc) [LC] - gdy elemnty nie mają być srtwane przez użytkwnika (np. lista pdstrn tekstwych, które nie będą nigdzie wyświetlane na frntendzie w frmie listy) t należy wyłączyć pkazywanie klejnści i srtwanie w góle - przez użycie tej metdy z argumentem 0. Wtedy też mżna zrbić srtwanie alfabetyczne. Ustawienia spisów dla katalgu: - pnieważ katalgi mają sbne typy elementów: pliki i katalgi t wszystkie ustawienia dla każdeg z tych typów są sbne. ddaj_extended_inf_plik($inf) [C] - czyli extended inf dla elemntu typu plik. ddaj_kpiuj_katalg($allw) [C] - tutaj d kńca nie pamiętam jak t działa i d czeg t służy ddaj_kpiuj_plik($allw) [C] - j.w. ddaj_rder_pliki($rder,$nazwa) [C] - srtwanie elementów typu plik. Nrmalny rder wtedy dnsi się d katalgów. ddaj_przycisk_katalg($nazwa,$funkcja,$zewnetrzny=0,$ikna='',$alert='') [C] - czyli metda ddająca funkcję jak nrmalne, ale wyświetlana przy elementach typu katalg YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

8 ddaj_przycisk_plik($nazwa,$funkcja,$zewnetrzny=0,$ikna='',$alert='') [C] - czyli metda ddająca funkcję jak nrmalne, ale wyświetlana przy elementach typu plik ddaj_spis_katalg($spis) [C] - czyli wyświetlanie elemntów typu katalg. Nrmalny spis dnsi się d pliku (wiem, bez sensu, ale tak t był). maksymalny_pzim($pzim) [C] - kreśla jaki jest maksymalny pzim d któreg mżna ddawać pdkatalgi. Pmim że jest t nieknieczne, t jest wysce zalecane, aby ustawić jakiś senswny pzim i nie pzwlić na nieskńczne zagnieżdżanie elementów w sbie. pis_select_katalg($pis) [C] - label jaki się wyświetla przy selectie z wybrem katalgu. W zależnści d teg jaką funkcję spełnia cały mduł mże t być np. Kategria pkaz_klejnsc_katalg($klejnsc) [C] - kreśla czy katalgi mają być również srtwane. Czyli nrmalny "pkaz_klejnsc" dnsi się d plików. pkaz_select_katalg($pkaz) [C] - kreśla czy ma być wyświetlny select z wybrem katalgu. Select mże być niewyświetlany jak dane są np. imprtwane z zewnętrzneg źródła i nie dajemy użytkwnikm mżliwści zmiany pszczególnych relacji pmiędzy tymi danymi, a jedynie dajemy im mżliwść edycji samych danych jak takich. Ustawienia pól: ddaj_zakladke($nazwa,$template='',$katalg='') [PLC] - ddawanie nwej zakładki z plami. $nazwa - nazwa zakładki, $template - pcjnalny template zakładki (gdy inny niż standardwy), $katalg - przy typie "katalg" kreśla czy zakładka tyczy się katalgu (=1) czy pliku (dmyślnie). Uwaga: zakładki nie działają przy typie "mdul2" ddaj_ple($ple,$numer=0) [PLC] - ddanie nweg pla d statni ddanej zakładki. Własne funkcje: - pzwala nam zdefiniwać w mdule własne metdy, które będą dpalane w kreślnych mmentach. Metdy te muszą być publiczne i statyczne. funkcje_ddaj($funkcja) [LC] - metda dpalana PO ddaniu newg rekrdu d bazy danych. Pzwala pbrać ID ddaneg właśnie rekrdu, ect. funkcje_ddaj_przed($funkcja) [LC] - metda dpalana PRZED ddaniem nweg elementu d bazy danych. Pzwala na mdyfikację danych POST, walidację, ect. funkcje_edytuj($funkcja) [PLC] - metda dpalana w mmencie kliknięcia przycisku edytuj PRZED wyświetleniem template'a. funkcje_usun($funkcja) [LC] - metda dpalana PRZED usunięciem rekrdu. funkcje_wczytaj($funkcja) [LC] - metda dpalana PRZED utwrzeniem spisu elementów funkcje_zmien($funkcja) [PLC] - metda dpalana PRZED update'em istniejąceg rekrdu w bazie danych. funkcje_zbacz($funkcja) [LC] - metda dpalana PRZED wyświetleniem rekrdu. Ustawienia przycisków - każdy z tych przycisków mżna ustawić na 0. Wtedy niektóre funkcje będą wyłączne. I tak: aktywnebuttn($bl) [LC] - wyłącza mżlwiść de/aktywwania rekrdów changebuttn($bl) [LC] - wyłącza mżliwść edycji rekrdów ddajbuttn($bl) [LC] - wyłącza mżliwść ddawania nwych rekrdów kpiujbuttn($bl) [LC] - wyłącza mżliwść kpiwania rekrdów YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

9 usunbuttn($bl) [LC] - wyłącza mżlwiść usuwania rekrdów zbaczbuttn($bl) [LC] - wyłącza mżliwść pdglądu rekrdów ddaj_plik($bl) [C] - wyłącza mżliwść ddawania elementów typu plik w katalgu mdul::add_selectin('nazwa selectu',$fields)[plc] -> gdzie 'nazwa selectu' t nazwa selecta z któreg się wybiera widczne pla fields. Jest t ddanie graniczenia widcznści pszczególnych pól w edycji wg. wybranej pcji w ple_select kreslnym w parametrze typ -> Przykład parametru $fields: $fields = array(array( name ), array( name, surname, ), array( name, surname )); Czyli każda pdtablica dpwiada analgicznie wg klejnści wybranej pcji w Selectie jakie pla będą widczne d edycji. Spisy elementów (dla spisu, i extended_inf) - twrzy się je jak nrmalne stringi. Dane z bazy danych mgą być wyświetlane p tczeniu ich "{}". Pnadt każda zmienna mże mieć następujące mdyfikatry (uruchamiane "{field mdificatr}"): select - gdy jest t zmienna pla select t zamiast klucza (wartści przechwywanej w bazie) wyświetlana jest wartść. Example:{plec select} mdul - zmienna jest brana z inneg mdułu (zazwyczaj na pdstawie "mdul2"). Nazwa mdułu p dwukrpku. Example: {categry mdul:categries} data - zamienia datę unixwą (standardw przechwywaną na nrmaną datę. Frmat pdawany p dwukrpku, brany z phpwskieg date(). Dmyślnie: 'd.m.y'. Example: {date data} (t jest t sam c: {date data:d.m.y}) strip_tags - czyści HTMLwskie tagi. Example: {fulltext strip_tags} zdjecie - wyświetla miniaturkę zdjecia z pdkatalgu "cms". Example: {pht zdjecie} slwnik - wyświetla wartśc tekstwą z pla typu słwnik. Example: {cuntry slwnik} -> Ddatkw w spisie i ext_inf mżna stswac ify. Niestety nie jest t idealnie zrbine i częst czasem mże nie działać, więc prszę używać z rzwagą. Example: {if \$data_rzpczet<>'0'}wystartwał: {data_rzpczet data:d.m.y G:i:s} {/if}. Z changelga: Isttna jest składnia! Każda zmienna, która ma być nadpisana przez krespndującą wartść elementu musi być pprzedzna ciągiem "\$", a następnie idzie nazwa pla w bazie danych. Pnadt przy teście z dwma mżliwściami należy pamiętać daniu spacji p "{else", a przed kńcem nawiasu klamrweg! Bez teg parser będzie myślał, że chdzi wyświetlenie wartści "else" testwaneg elementu! Każdy {if} musi być zamknięty przez {/if}! -> Pdczas zapisu edycji pszczególneg elementu spisu lub strny, gdy klikniemy Zapisz mżliwe jest pdmiana napsiu infrmująceg zapisie. Dknuje się teg na 2 spsby (w zależnści w którym miejscu dknujemy zmian): 1)dla mdyfikacji listy: tpl::utwrz()->assign('cms_zmienine', 'tekst'); YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

10 2) Dla mdyfikacji elementu: tpl::utwrz()->assign('cms_text', array('psitin'=>'alter', 'text'=>'tekst')); Przy czym parametr psitin mże przybierać różne wartści (d pczytania w changelg). -> Istneje mżliwść pjedynczeg zablkwania edycji danych w bazie p naciśnięciu przycisku Zapisz w CMS (lecz POSTY zstaną wysłane czyli w CMS zbaczymy zmiany) pleceniem: cnfig::set('addedititemlck','1') Katalg Mduły/Pla/ Katalg /mduly/pla/ zawiera klasy pisujące pla wykrzystywane w klasach mdułów. Przykłady wykrzystania pól są pkazane w pisach klas, tutaj. Zawiera następujące klasy: /ple.class.php - standardwa klasa pla, dziedziczna przez pdklasy. Psiada następujące właściwści: Class(string) - klasa pla (dsłwnie HTMLwski class="") ClassDiv(string) - klasa diva zawierająceg ple (HTMLwski class="") Disabled(0/1) - ddaje atrybut disabled="disabled" Help(string) - ddaje pis d labela z plem. Opis wyświetla się p najechaniu myszką i pnieważ jest n przypisany d atrybutu rel="" t nie pwinien zawierać cudzysłwiów. Id(string) - id pla Katalg_pzim(string) - pwduje że t ple raz wszystkie klejne są przypisane d knkretneg pzimu w katalgu. Name(string) - nazwa pla w bazie danych. Pwinna być unikalna. Zastrzeżne nazwy t: id_, user, grupa, mdul, klejnsc, rdzic, lang, aktywne raz dla typu katalg system_katalg Opis(string) - label pla. Pwinien wyjaśniać d czeg służy, ale nie pwinien być długi. Więcej infrmacji mżna zawrzeć w Helpie. Other(string) - pzwala dpisać własny kd d pla. Readnly(0/1) - ddaje atrybut readnly="readnly". Różnica pmiędzy readnly a disabled jest taka, że t pierwsze ple jest zmieniane w bazie danych, pmim że nie mże być zmieniane w plu, natmiast t drugie ple nie jest zmieniane (nie jest wysyłana nawet wartść zmiennej w POST) sprawdz(?) - sprawdzenie pprawnści pól. OD RAZU MÓWIĘ, ŻE NIE DZIAŁA. SqlType(string) - kreśla jakieg typu będzie ple w bazie. Zmienna ma pstać "typ dlugsc dmyslnie", np. "int 20 0" Type(?) - typ pla. W zasadzie nieptrzebne i niewykrzystywane Value(string) - wartść z bazy danych. Mżna ją nadpisać lub ustawić gdy chcemy jakąś dmyślną. Pnadt każda klasa dziedzicząca p klasie ple pwinna psiadać następujące metdy: cde() - twrząca kd HTML pla dla edycji shw() - twrząca kd HTML pla dla pdglądu (czyli pkazująca wartść daneg rekrdu w bazie danych bez mżliwści zmian) translate() - wykrzystywana przy eksprcie a tłumacząca wartść w bazie danych na wartść d eksprtu. Pla bez tej metdy będą pmijane przy eksprcie. YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

11 /ple_buttn.class.php - ple typu buttn. Nie ma żadnych ddatkwych właściwści. Rzadk wykrzystywane /ple_checkbx.class.php - ple typu checkbx. Zapisuje w jednym plu wiele rekrdów. Dzieli klucze za pmcą "()". Czyli np. twrzy w bazie danych wartść "(1)(2)(5)". Psiada następujące metdy: ddajpcje($wartsc, $pis) - ddaje pcję kreślnej wartści i nazwie twrzgrupe($pis) - twierającą grupę wartści. Pzwala w ten spsób agregwać wartści kreślnych częściach wspólnych w ramach grupy. zamknijgrupe() - zamyka twartą wcześniej grupę /ple_checkbx_baza.class.php - ple typu checkbx, pdbne jak zwykłe checkbx, ale nie psiada mżliwści ddawania ani grupwania elementów, a pbiera je sam z bazy. Psiada następujące właściwści: Mdul_nazwa(string) - wartść z pla "mdul" w bazie danych (pdbnie jak zmienna $mdul_nazwa w /cnfig/panel_menu.php) OrderBy(string) - ple p którym ma srtwać w bazie danych - idzie bezpśredni d zapytania p ORDER BY Pla_mdul(string) - nazwa pliku klasy zawierająceg definicję mdułu (pdbnie jak zmienna $mdul_rdzaj w /cnfig/panel_menu.php) Where(string) - pcjnalny warunek WHERE d zapytania w bazie danych Wybr(string) - nie działa, pzstałść p starej wersji Wyswietlanie(string) - kreśla jak ma być przedstawiane wyświetlanie rekrdów. Mżna używać zmiennych z daneg rekru w pstaci: "{klucz}" - spwduje t przypisanie wartści przechwywanej w bazie danych pd wspmnianym kluczem dla każdeg rekrdu. /ple_czas.class.php - ple tekstwe, które przechwuje czas w frmacie "H:i". Rzadk stswane (zazwyczaj występuje jak mdyfikacja ple_data. Psiada metdę: Autuzupelnianie(0/1) - w przypadku gdy ddawany jest nwy rekrd t przyjmuje bieżącą wartść czasu. Dmyślnie 0 /ple_data.class.php - ple tekstwe, które przechwuje datę w frmacie unixwym. D twrzenia daty wykrzystuje skrypt calendar.js (ze strny Psiada metdy: Autuzupelnianie(0/1) - w przypadku gdy ddawany jest nwy rekrd t przyjmuje bieżącą wartść czasu. Dmyślnie 0 Frmat(string) - frmat daty w plik JS. Pnadt autmatycznie zamienia ten frmat również w PHP (przez skaswanie "%"), c działa w większści przypadków. Dmyślnie "%d.%m.%y" Php_frmat(string) - frmat daty w PHP. Dmyślnie "d.m.y" Time(0/1) - kreśla czy wyświetlać również wybór czasu, czy tylk daty. Dmyślnie 0 Time_frmat(24/12) - kreśla w jakim frmacie ma wyświetlać frmat czasu. Dmyślnie 24 /ple_file.class.php - ple d wysyłki plików. Pliki są umieszczne w katalgu ustawianym w zmiennej $resurcesflder w cnfig/cnfig.php. Dmyślnie w "resurces" i ta wartść jest zalecana. Psiada właściwść: Pdkatalg(string) - zapisuje pliki z teg pla d kreślneg pdkatalgu. Zalecane nie używanie zmiennych liczbwych, gdyż w tych pdkatalgach są zapisywane klejne skalwania zdjęć. Pnadt psiada metdę: YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

12 rzszerzenie(string) - lista rzszerzeń akceptwanych przez ple. Rzszerzenia są wymieniane p przecinu i na serwerze będą zapisywane tylk pliki psiadające dkładnie takie rzszerzenie. Przykład: "pdf,dc,xls,psd". /ple_file2.class.php - nwa wersja pla d wysyłki pliku w trybie asynchrnicznym (FLash). Zalecane jest stswanie teg pla, gdyż ułatwia manipulwanie już przesłanymi plikami. Właściwści pla jak wyżej. /ple_freign_key.class.php - ple analgiczne d działania jak select. Bardz rzadk wykrzystywane, gdyż z zasady klucz bcy pwinien mieć pwiązanie w bazie danych (jak ple_freign_key_baza) a nie mieć ręcznie wpisywane wartści. /ple_freign_key_baza.class.php - ple analgiczne d działania jak select_baza. W zasadzie t jest właściwe ple dla klucza bceg. W dróżnieniu d pla select_baza ple freign key twrzy sbną tabelę w bazie danych nazwie "{prefix}_freign_key_{name}" i przechwuje w niej rekrdy pwiązane według klucza i referencji. Z teg względu mżna edytwać elementy zarówn d strny klucza jak i referencji. Przykład: news mże być przypisany d wielu kategrii. W przypadku użycia w mdule newsów pla select_baza tylk edytując newsa mżna zmienić przypisanie kategrii. W przypadku stswania pla freing_key_baza mżemy zmieniać kategrie przypisane d newsa edytując newsa raz zmieniać newsy przypisane d kategrii edytując kategrię. Czyli pzwala nam t edytwać pwiązania z bu strn. Ważne: z pwdu zasady działania przy wykrzystaniu pla freign_key nie mamy mżliwści własneg srtwania elemntów (właśnie dlateg że elementy mżemy przypisywać d dwóch strn). Ple psiada następujące właściwści: Editable(?) - przyznam szczerze, że nie wiem d czeg t służy Klucz(string) - ple w tabeli z freign_key dnszące się d bieżąceg mdułu Mdul_nazwa(string) - wartść z pla "mdul" w bazie danych (pdbnie jak zmienna $mdul_nazwa w /cnfig/panel_menu.php) OrderBy(string) - ple p którym ma srtwać w bazie danych - idzie bezpśredni d zapytania p ORDER BY (ważne, z tabeli klasy relacyjnej) Pla_mdul(string) - nazwa pliku klasy zawierająceg definicję mdułu (pdbnie jak zmienna $mdul_rdzaj w /cnfig/panel_menu.php) Referencja(string) - ple w tabeli z freign_key dnszące się d relacyjneg mdułu. Referencja i klucz w dwóch łączących się klasach są zależne (t c w jednej klasie jest referencją, w drugiej jest kluczem i vice versa) Where(string) - pcjnalny warunek WHERE d zapytania w bazie danych (z tabeli klasy relacyjnej) Wybr(string) - t w zasadzie jest nieptrzebne Wyswietlanie(string) - t również Czyli, jeżeli mamy ple freign_key łączące nam klasę newsy z klasą kategrie t: klasa newsy ma Mdul_nazwa ustawine na nazwę klasy kategri, Pla_mdul na dpwiednią wartść ustawiną w /cnfig/panel_menu.php. klasa kategri ma Mdul_nazwa ustawine na nazwę klasy newsów, Pla_mdul na dpwiednią wartść ustawiną w /cnfig/panel_menu.php. ple w klasie newsy ma za referencję "kategrie", a za klucz "newsy", ple w klasie kategrie dwrtnie ple w klasie newsy ma OrderBy ustawiny z tabeli "kategrii", a ple w klasie kategrie z tabeli "newsy" YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

13 /ple_hidden.class.php - ukryte ple nie psiadających żadnych ddatkwych właściwści. Najprstszy spsób na zapisanie w bazie danych kreślnych, niezmiennych wartści - typu ustawianie flag, ect. Np: ple przechwujące w bazie danych wartść długści i szerkści gegraficznej dla daneg adresu. W przypadku gdy dane te są dczytywane przez zewnętrzny skrypt wart ustawić t tak, żeby był dczytywane tylk przy pierwszym ich wykrzystaniu i zapisaniu w dpwiednich plach. Przy klejnych wykrzystaniach nie ma ptrzeby używania skryptów, gdyż dane są już zapisane w bazie. Natmiast przy edycji adresu pla długści i szerkści są zerwane i dzięki temu mgą być d nwa później dczytywane. /ple_image.class.php - ple typu image. Nie wykrzystywane raczej nigdy. /ple_katalg.class.php - ple d wybru katalgu. Pza autmatycznym użyciem teg pla w mdule typu katalg, nie wykrzystywane. /ple_klr.class.php - ple d wybru klru. Wykrzystuje skrypt JS Farbtastic Clr Picker 1.2. Nie psiada ddatkwych metd ani właściwści. /ple_mdul2.class.php - ple d umieszczania mdułu w mdule. W zasadzie sprwadza się d umieszczenia spisu w spisie lub strnie. Np. d pjedyńczeg newsa mżemy ddać listę tagów, zdjęć, ect. Częst używany. W właściwści name pdajemy nazwę klasy definiującej pdmduł i z nieg są brane wszystkie ustawienia. W bazie danych ptmek psiada następujące wartści: rdzic jest równy "id_" rdzica, mdul jest równy "mdulwi" rdzica. Pdklasy nie ddaje się d cnfiga, ustala się ją tylk w plach. Alternatywny spsób dłączania pdspisów jest stswanie pdmdułów (pisane w tej dkumentacji też). /ple_mdul3.class.php, /ple_mdul.class.php - pzstałść p różnych rdzajach pdmdułów. Nie wykrzystywana i raczej nawet nie działająca. /ple_pis.class.php - ple d ddania pisu. Nie jest zapisywane d bazy danych. Psiada pgrubineg labela z właściwści Opis raz wartść z właściwści Value (mże być HTMLem). /ple_passwrd.class.php - ple d zapisu haseł. Przy edycji nie pbiera ani wyświetla wartści. Wartść w bazie danych jest zapisywana tylk w przypadku wypełnienia teg pla, gdy ple jest puste nic się nie dziele (przez t nie ma mżliwści usuwania hasła). W bazie danych hasł jest przechwwywane w pstaci zakdwanej (dmyślnie przez md5). Mżna zmienić typ kdwania na sha1 za pmcą właściwści encde /ple_radi.class.php - ple pdbne d checkbxa, tylk że mżna zaznaczyć tylk jedną mżliwść. Cś takieg jak select, przez t w zasadzie nie wykrzystywane. W zasadzie użyty tylk w przypadku gdy d wybru nie jest tekst a grafika (np. banner). Wykrzystuje metdę: ddajpcje($wartsc, $pis) - ddaje pcję kreślnej wartści i pisie (mże być HTML) /ple_select.class.php - ple pdbne d radi i wykrzystywane najczęściej d wybru jednej pcji. Ma c prawda mżliwść wybru większej liczby pcji za pmcą właściwści multiple, ale w tym wypadku lepiej skrzystać z pla checkbx. Psiada takie same metdy jak tamt ple, czyli: ddajpcje($wartsc, $pis) - ddaje pcję kreślnej wartści i nazwie twrzgrupe(string) - twierającą grupę wartści. Pzwala w ten spsób agregwać wartści kreślnych częściach wspólnych w ramach grupy. zamknijgrupe() - zamyka twartą wcześniej grupę /ple_select_baza.class.php - ple pdbne d checkbx_baza. Pbiera pcje z inneg mdułu i wyświetla jak nrmalny select. Nie ma mżliwści grupwania, więc jak trzeba pgrupwać p kilku typach elementów należy samemu pbrać z bazy i wywietliś w nrmalnym selecie. Wykrzystuje metdy: YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

14 ddajpcje($wartsc, $pis) - ddaje pcję kreślnej wartści i nazwie, wyświetlane na samej górze listy Mdul_nazwa(string) - wartść z pla "mdul" w bazie danych (pdbnie jak zmienna $mdul_nazwa w /cnfig/panel_menu.php) OrderBy(string) - ple p którym ma srtwać w bazie danych - idzie bezpśredni d zapytania p ORDER BY Pla_mdul(string) - nazwa pliku klasy zawierająceg definicję mdułu (pdbnie jak zmienna $mdul_rdzaj w /cnfig/panel_menu.php) Where(string) - pcjnalny warunek WHERE d zapytania w bazie danych Wybr(string) - nie działa, pzstałść p starej wersji Wyswietlanie(string) - kreśla jak ma być przedstawiane wyświetlanie rekrdów. Mżna używać zmiennych z daneg rekru w pstaci: "{klucz}" - spwduje t przypisanie wartści przechwywanej w bazie danych pd wspmnianym kluczem dla każdeg rekrdu. /ple_slider.class.php - ple twrzące slidera d wprwadzania integerów. Wykrzystuje slider z UI jquery. Psiada metdy: between(int,int) - pzwala kreślić minimum i maksimum w jednym wywłaniu minimum(int) - wartść minimalna (dmyślnie 0) maximum(int) - wartść maksymalna range("left/right/true") - "left" = slider, z lewej strny (dmyślnie), "right" - slider z prawej strny, "true" = slider przechwuje wartść w frmacie "d - d" step(int) - kreśla skk (dmyślnie c 1) /ple_slwnik.class.php - ple twrzące inputa typu słwnikweg. Dść rzadk wykrzystywany. Ple twrzy sbną tabelę w bazie danych nazwie "{prefix}_slwnik_{tabela}". Psiada właściwści: klucz(string) - wartść klumny klucza (dmyślnie "id_" - zalecane) lang(string) - wartść klumny języka (dmyślnie "lang" - zalecane) nazwa(string) - wartść klumny przechwującej nazwę (dmyślnie "nazwa") tabela(string) - nazwa tabeli w bazie danych where(string) - pcjnalny warunek Where (raczej nie używany) /ple_submit.class.php - ple twrzące inputa typu submit. Nie wykrzystywany wcale. /ple_tak_nie.class.php - ple twrzące inputa przechwująceg wartść zer-jedynkwą. Dmyślnie wstępnie jest ustawiny na wartść "1". Psiada metdę: reverse() - pwduje, że nwe elementy mają wstępnie ustawiną wartść "0" /ple_text.class.php - nrmalne ple twrzące standardweg inputa typu text. Najczęściej i najszerzej wykrzystywany. Brak ddatkwych metd. /ple_text_link.class.php - nie wykrzystywane. /ple_textarea.class.php - ple twrzące standardwe textarea. Psiada właściwści: cls(int) - ilść klumn (HTMLwski "cls") height(int) - wyskśc - najczęściej zmieniana rws(int) - ilść wierszy (HTMLwski "rws") width(int) - szerkść /ple_textedit.class.php - ple twrzące edytr ckeditr. Psiada właściwści: cls(int) - ilść klumn (HTMLwski "cls") height(int) - wyskśc - najczęściej zmieniana rws(int) - ilść wierszy (HTMLwski "rws") tlbar("full/advanced/basic") - rdzaj paska narzędzi. Dmyślnie Full. width(int) - szerkść YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

15 /ple_wyswietl_baza.class.php - nie wykrzystywane. /ple_zdjecie.class.php - ple pzwalające na wysyłanie zdjęć na serwer. Pliki są umieszczne w katalgu ustawianym w zmiennej $resurcesflder w cnfig/cnfig.php. Dmyślnie w "resurces" i ta wartść jest zalecana. Ddatkw twrzą się miniaturki w pdkatalgach: cms - miniaturka d CMSa (max 70x70), a następnie d 1 wzwyż każda klejna. Ple psiada właściwść: inny_flder(string) - flder w którym ma zapisywać pliki. wsplrzedne(mixed) - współrzędne d skalwania (dcinania zbędnych części). Składa się z dwóch liter: 'T' - tp,'b' - bttm, 'M' - middle ORAZ 'L' - left, 'R' - right, 'C' - center. Dmyślnie MC Ple pnadt psiada metdę: ddaj(width,height,type) - ddającą skalwanie. Skalwań mże być d 1 d... ilu trzeba. Każde skalwanie będzie zapisywane d klejneg pdkatalgu pczynając d 1. Każde musi również psiadać szerkść i wyskść raz typ. Dstępne są następujące typy: 1 - skaluje tak aby zdjecie zmiescil sie w danym przedziale. Czyli mniejsze zdjęcie będzie przekpiwane, a większe będzie zmniejszne prprcjnalnie tak, aby większy z wymiarów mieścił się w przedziale (czyli mniejszy na pewn też się zmieści). Przykład: ustawine 200x300, plik 100x100 będzie miał 100x100. Plik 400x400 będzie miał 200x200 (będzie zmniejszny prprcjnalnie aby ba wymiary się zmieściły). Czyli skalwanie t kreśla maksymalną wyskść i szerkść pliku wynikweg, bez jeg zniekształcania. 2 - skaluje zdjęcie dkładnie d rzmiaru, zniekształcając. Czyli mniejsze zdjęcie będzie pwiększne, a większe będzie zmniejszne tak, aby każdy z wymiarów miał tyle ile pdan. Przykład: ustawine 200x300, plik 100x100 będzie zwiększny 2x na szerkść i 3x na wyskść. Plik 400x400 będzie zmniejszny na wyskść 33% i zmniejszny na szerkść 2x. Czyli skalwanie t kreśla dkładną wyskść i szerkść pliku wynikweg, ale zniekształca g. 3 - skaluje zdjęcie dkładnie d rzmiaru, bcinając zbyteczne bki. Czyli mniejsze zdjęcie będzie przekpiwane, a większe będzie zmniejszne prprcjnalnie tak, aby większy z wymiarów miał tyle ile pdan, a z mniejszeg zstanie ucięte t c jest pnad (w zależnści d ustawień współrzędnych startu d lewej, prawej, śrdka, góry, dłu - dmyślnie zstawia śrdek). Przykład: ustawine 200x300, plik 100x100 będzie miał 100x100. Plik 400x400 będzie najpierw zmniejszny prprcjnalnie d 300x300, a następnie z wyskści zstanie ucięte 100 px (czyli dmyślnie p 50px z góry i dłu). Czyli skalwanie t kreśla dkładną wyskść i szerkść pliku wynikweg, bez zniekształcania, ale z mżliwym bcięciem teg c zbyteczne. 6 - skalwanie z crpem. Czyli najpierw należy wysłać plik na serwer, a następnie przy klejnej edycji pjawia się mżliwść crpwania z teg zdjęcia. Minusy: trzeba 2x edytwać (raz żeby wysłać plik na serwer, a dpier drugi raz żeby scrpwać). 7 - skalwanie takie jak 1 tylk zdjęcie wynikwe ma zawsze taki sam rzmiar i jest wyśrdkwane. YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

16 Katalg Mduły/Utilities/ Install.php Katalg /mduly/utilities/ zawiera ddatkwe, pmcnicze klasy wykrzystywane d budwy frnt- raz backendu. -> Najważniejszym elementem w tym katalgu są pliki: a) baza_ext (niezmienialny służy d bsługi baz danych mżna przeglądać g by dwiedzieć się jakich parametrów używać d bsługi baz) b) devtls tu w zasadzie d zmiany jest tylk typ raprtwania błędów raz c najważniejsze ustawienie tablicy IP numeru z któreg prgramujemy należy pdac właściwy numer by móc przegladac lgi, błędy i kmunikaty PHP naszeg prjektu. 1) Aby widzieć płączenia z bazą danych raz tablicę lgów wyknywaneg skryptu należy d adresu URL czy t w CMS czy na strnie dpisać :?lguj=tak 2) Gdy chcemy wyłączyć lgwanie piszemy:?lguj=nie Te plecenia najlepiej wpisywać w adres URL z krótkim ciągiem URI by zadziałał. Skrypt instalacyjny dla CMSa: Główny plik instalacyjny CMSa. Zmienia strukturę tabel w bazie danych, ddaje prawa dstępu dla admina, twrzy menu w bazie. Nie kasuje nieużywanych pól, ddaje tylk nwe. Skrypt pwinien być uruchamiany przy: ddaniu nwych pól d klas, ddaniu nwych elementów d menu, ddaniu języka. W tych najprstszych sytuacjach skrypt autmatyzuje wprwadzanie zmian d CMSa. Dmyślnie nie kasuje tabel, ale mżna t zmienić. POWINIEN BYĆ SKASOWANY NA SERWERZE PRODUKCYJNYM!. Psiada następujące pcje: cnfig::ddaj('install_delete_tables',0); - przy ustawiniu na "1" kasuje wszystkie tabele! Używać z rzwagą!!! Nie zalecane cnfig::ddaj('instalwanie','tak'); - ustawia flagę że skrypty są instalwane. Przez t w klasach mdułów mżna wyłączyć niektóre pcje (np. pbieranie elementów dynamicznych - pdelementów, ect. b mgą jeszcze nie być utwrzne tabele z nimi). Cding Standards PHP Kdwanie YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

17 klasy, funkcje i zmienne nazywamy stsując frmaty wielkiej litery dla każdeg słwa. Pierwsza litera jest mała, np. ($jakasprzykladwazmienna) stsujemy dłuższe, ale WYRAŹNIE infrmujące nazwy (nie krzystać ze zmiennych typu $a, ect.) wyjątek d pwyższeg stanwią: zmienne niewykrzystywane, tymczaswe lub iteratry pmim, że dmyślnie w PHPie jak funkcje nie mają kreślneg zasięgu t mają zasięg "public", należy pisać jaki jest zasięg stswać frmat zapisu: [final][static]private/public/prtected nie krzystamy z shrthandów d twarcia skryptów: każdy musi się zaczynać d <?php a kńczyć na?> Wcięcia Stsujemy frmatwanie kdu typu: BSD KNF style. Czyli: nawias w instrukcji stsujemy p spacji (nie dtyczy funkcji - tu dajemy bezpśredni p nazwie) twarcie klamry znajduje się w tej samej linijce c instrukcja, p spacji (np. if ($a==1) {) wyjątek: p deklaracji klasy klamrę twieramy w nwej linijce każdy kd wcinamy stsując jedną tabulację mżna nie stswać klamer w przypadku pjedynczych instrukcji, ale i tak muszą się znaleźć w nwej linijce p wcięciu mżna stswać pjedyncze instrukcje warunkwe inline typu: ($a==1)? '1' : '2';, ale nie należy ich zagnieżdżać w nwej linijce jest zamknięcie klamry (raz pcjnalne else) pmiędzy funkcjami jedna linijka przerwy przykład dbreg kdu: if (warunek1) { while (warunek2) zrbcs(); zrbcsjeszcze(); } else { csinneg(); } HTML i CSS Struktura katalgów stsujemy następującą strukturę plików /css/ - pliki css serwisu. Główny plik pwinien mieć nazwę taką jak prjekt, np. yellwteam.css /js/ - pliki js serwisu, łącznie z dłączanymi biblitekami. JW. główny plik nazywa się jak prjekt. Tutaj pcjnalnie mgą znajdwać się pdkatalgi z plikami css raz graficznymi dla dłączanych kmpnentów. YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

18 /imgs/ - pliki z elementami graficznymi - tylk te, które są wykrzystywane w serwisie. Czyli pliki tła, ikn, przycisków. /resurces/ - pliki z przykładwymi zdjęciami raz elementami dynamicznymi (wysyłanymi z panelu). P przesłaniu na serwer tutaj będą znajdwać się wszystkie pliki wysyłane przez użytkwników, w związku z tym muszą mieć prawa 777. /dcs/ - pliki z elementami dkumentacyjnymi - czyli wszelkie briefy, psdki, struktury, dkumentacje, ect. Teg katalgu nie umieszcza się w repzytrium svn (w związku na duży rzmiar) Kdwanie piszemy w standardzie XHTML 1.0 Strict ddajemy Meta Tagi - Title, Keywrds raz Descriptin ddajemy następujący kd: <meta name="authr" cntent="yellwteam.pl" /> ddajemy favicna: <link rel="shrtcut icn" href="favicn.ic" /> - w przypadku braku specyficzneg ddajemy dmyślny upewniamy się, że strny html wyglądają pdbnie na następujących przeglądarkach: Opera 11+, Firefx 6+, IE 7+, Chrme 13+, Safari 5+ ddajemy d każdeg brazka atrybut alt upewniamy się że HTML i CSS przechdzą walidację: HTML, CSS (strna mże się nie walidwać jedynie w przypadku rzwiązań zewnętrznych lub hacków) sprawdzamy jak strna się waliduje dla przeglądarek mbilnych: Mbile Stylwanie nie ddajemy styli inline! Wyjątek gdy np. szerkść zależy d ilści elementów pbieranych z panelu. unikamy stylwania p id, a stsujemy klasy gdy mamy menu graficzne t wrzucamy wszystk d jedneg pliku łącznie ze stanami aktywnymi - te włączamy pprzez przesunięcie grafiki w dół klasy pwinny kreślać czym są, w związku z tym nie pwinny przyjmwać nic nie znaczącej pstaci, np. "prbc" stsujemy reset cssów na pczątku każdeg arkusza stylów piszemy w układzie "klumnwym", czyli k 2/5 szerkści ekranu zajmują znaczniki, a resztę style gdy style zajmują więcej niż jedną linijkę klejne pwinny mieć jedn wcięcie więcej niż pierwsza każdy element zawierający grafikę (typu buttny, ect) pwinien psiadać treść równą treści na grafice ukrywaną przez verflw:hidden; text-indent:-999px; lg pwinn linkwać d strny głównej i pwinn zawierać treść taką jak na lgu (nazwę firmy, slgan, ect.) stsujemy prawidłwą semantykę: jeden H1, dwa H2, kilka H5 przykład dbreg kdu:.hme-cntent.ffer-texts {padding:22px 0 13px 23px;}.hme-cntent.ffer-texts h5 {flat:left; display:blck; width:377px; height:53px; text-indent:-999px; verflw:hidden; YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

19 backgrund:url(../imgs/main-steps-1.png) n-repeat; padding:0 190px 0 0; margin:0;} JS Kdwanie stsujemy biblitekę jquery nie krzystamy z shrthandów, czyli piszemy jquery zamiast $ nie dłączamy innych framewrków, gdyż częst lubią się pgryźć nie ddajemy skryptów inline nie ddajemy skryptu d bdy ninit, zamiast teg stsujemy: jquery(dcument).ready(functin() { }); YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,

20 Spis treści Struktura katalgów... 2 Katalg Cnfig... 3 Katalg Mduły... 4 Katalg Mduły/Jądr/... 5 Katalg Mduły/Mduły/... 5 Katalg Mduły/Pla/ Katalg Mduły/Utilities/ Install.php Cding Standards PHP HTML i CSS JS YELLOWTEAM.PL Krzysztf Kuc Długa 1 lk. 216 (2 piętr), Kraków biur@yellwteam.pl,