A – Adownload.tutoriali.org/Tutorials/Web_Aplikacije/Orchard.pdf · 1.2.5. Podesavanja sajta ......
Transcript of A – Adownload.tutoriali.org/Tutorials/Web_Aplikacije/Orchard.pdf · 1.2.5. Podesavanja sajta ......
ELEKTRONSKO POSLOVANJE – VISOKA
TEHNIČ KA S KOLA STRUKOVNIH STUDIJA
KRAGUJEVAČ Orchard je internet CMS, koji pomaže da sagradite sajt iz nekoliko
osvnovnih delova.
Autori:
Ivan Ilić
Alesandar Mitrović
Bogdan Ilić
Maja Spasić
Marko Milojković
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 1
Sadržaj 1. Prvi koraci u Orchardu ................................................................................................................ 5
1.1. Instaliranje Orchard-a .......................................................................................................... 5
1.1.2. Zahtevi .......................................................................................................................... 5
1.1.3. Instaliranje Orchard-a ................................................................................................... 6
1.1.4. Pokretanje Orchard-a u web Matrix-u .......................................................................... 7
1.2. Ručno instaliranje Orchard Zip fajla.................................................................................... 8
1.2.1. Skidanje .zip fajla.......................................................................................................... 8
1.2.2. Pokretanje sajta koristeći IIS ........................................................................................ 9
1.2.3. Pokretanje sajta koristeci WebMatrix i IIS Express ...................................................... 9
1.2.4. Pokretanje sajta koristeci Visual studio i Visual Studio Development Derver ........... 10
1.2.5. Podesavanja sajta ........................................................................................................ 10
1.3. Rad sa Orchard-om u webMatrix-u ....................................................................................11
1.3.1. Instaliranje I pokretanje WebMatrix-a .........................................................................11
1.3.2. Instaliranje Orchard-a unutar webMatrix-a ................................................................ 12
1.3.3. Pokretanje Orchard sajta prvi put ............................................................................... 13
1.3.4. Rad sa fajlovima ......................................................................................................... 14
1.3.5. Rad sa bazom podataka ............................................................................................... 14
1.3.6. Objavljivanje vaseg Web sajta .................................................................................... 16
1.4. Rad sa vašim prvim Orchard sajtom .................................................................................. 16
1.4.1. Prilagođavanje pocetne stranice Orchard-a ................................................................ 16
1.4.2. Dodavanje nove stranice na vas sajt ........................................................................... 17
1.4.3. Dodavanje Blog-a na vas sajt ...................................................................................... 19
1.4.4. Upotreba komentara i tagova(oznaka) ........................................................................ 22
1.4.5. Izbor Teme .................................................................................................................. 24
1.4.6. Prosirenje Orchard-a sa Modulima i ostalim karakteristikama ................................... 25
1.4.7. Rad u okviru kontrolne table ( Dashboard-a ) ............................................................ 26
1.5. Dodavanje stranica na vas sajt ........................................................................................... 28
1.5.1 Kreiranje nove stranice ................................................................................................ 28
1.5.2. Linkovi ........................................................................................................................ 29
1.5.3. Tagovi sa sadrzajem .................................................................................................... 29
1.5.4. Prikazi na glavnom meniju ......................................................................................... 29
1.5.5. Komentari od strane korisnika .................................................................................... 30
1.5.6. Kako koristiti RICH-TEXT editor .............................................................................. 30
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 2
1.5.7. Cuvanje i objavljivanje stranice .................................................................................. 31
1.6. Navigacija I meniji ............................................................................................................. 31
1.7. Dodavanje bloga na vas sajt ............................................................................................... 32
1.7.1. Kreiranje novog bloga ................................................................................................. 32
1.7.2. Kreiranje novog blog post-a ........................................................................................ 33
1.8. Dodavanje i organizovanje medijskih sadržaja .................................................................. 34
1.9. Upravljanje widgets-ima .................................................................................................... 38
1.9.1. Slojevi,Zone I Widget-i ............................................................................................... 38
1.9.2. Dostupni widget-i........................................................................................................ 38
1.9.2. Lista Lejera ................................................................................................................. 39
1.9.4. Lista Zona ................................................................................................................... 40
1.9.5. Dodavanje Lejera ........................................................................................................ 40
1.9.6. Dodeljivanje widget-a na zone.................................................................................... 41
1.9.7. Izmena ili Brisanje Widget-a ...................................................................................... 42
1.10. Organizovanje sadrzaja uz pomoć oznaka ....................................................................... 43
1.11 Kreiranje listi ..................................................................................................................... 44
1.11.1. Kreiranje Sopstvenih Sadrzivih Tipova Vaseg Sadrzaja ........................................... 44
1.11.2. Kreiranje Liste Knjiga ............................................................................................... 49
1.11.3. Kreiranje Stavke Sadrzaja Knjige ............................................................................. 50
1.11.4. Prikazivanje Liste ...................................................................................................... 51
2. Upravljanje sajtom .................................................................................................................... 52
2.1. Orchard galerija modula .................................................................................................... 52
2.1.1. Odabir modula iz galerije............................................................................................ 52
2.2.2. Gallery project ............................................................................................................ 53
2.2.3. Instaliranje modula i tema iz galerije .......................................................................... 54
2.3. Omogućavanje i onemogućavanje karakteristika .............................................................. 56
2.4. Izmena podešavanja sajta .................................................................................................. 59
2.4.1. Opšta podešavanja ...................................................................................................... 59
2.4.2. Podešavanja galerije.................................................................................................... 60
2.4.3. Podešavanje komentara ............................................................................................... 60
2.4.4. Podešavanje medija ..................................................................................................... 61
2.4.5. Podešavanje korisnika ................................................................................................. 61
2.5. Uređivanje komentara ........................................................................................................ 62
2.5.1. Upravljanje komentarima ............................................................................................ 62
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 3
2.5.2. Opšta podešavanja komentara..................................................................................... 63
2.6. Upravljanje sa korisnicima i ulogama ................................................................................ 66
3. Kreiranje teme ........................................................................................................................... 69
3.1. Writing a new Theme: ........................................................................................................ 69
3.1.1. Generating a new Theme: .......................................................................................... 69
3.1.2. Creating Styles for Your Theme .................................................................................. 69
3.1.3. Adding a Layout to Your Theme ................................................................................. 73
3.1.4. Adding a Theme Image ............................................................................................... 73
3.1.5. Applying a New Theme .............................................................................................. 74
3.2. Anatomy of a theme ........................................................................................................... 75
3.2.1. Where Themes Live .................................................................................................... 75
3.2.2. TheThemeMachine ..................................................................................................... 75
3.2.3. Anatomy of a Theme ................................................................................................... 75
3.3. Understanding placement info ........................................................................................... 81
3.3.1. The placement.info File .............................................................................................. 81
3.3.2. Scope ........................................................................................................................... 82
3.3.3. The "Placement" Element ........................................................................................... 82
3.3.4. ”Place" Element .......................................................................................................... 82
3.3.5."Match" Element .......................................................................................................... 83
3.3.6. Overriding Placement ................................................................................................. 83
3.4. Packaging and sharing themes ........................................................................................... 83
3.4.1.Viewing the Packaging Modules ................................................................................. 83
3.4.2. Packaging Your Theme ............................................................................................... 85
3.4.3. Uploading Your Theme to Gallery .............................................................................. 85
3.4.4. Installing a Packaged Theme ...................................................................................... 85
3.5. UI guidelines for theme authors ......................................................................................... 87
3.5.1. General Guidelines...................................................................................................... 87
3.5.1.16. Progressive Enhancements......................................................................................... 92
3.6. Customizing Orchard using Designer Helper Tools .......................................................... 93
3.6.1 Getting Started with Shape Tracing ............................................................................. 93
3.6.2. Shape Information ....................................................................................................... 93
3.6.3. Creating Alternate Templates ...................................................................................... 94
4. Proširenje Orcharda .................................................................................................................. 95
4.1 Uvod .................................................................................................................................... 95
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 4
4.1.1. Pregled rola u Orchardu .............................................................................................. 95
4.2. Kako orchard radi .............................................................................................................. 98
4.2.1. Arhitektura .................................................................................................................. 98
4.2.2. Temelji Orcharda ......................................................................................................... 98
4.3. Code generator ................................................................................................................... 99
4.4. Kreiranje “Hello world” modula ...................................................................................... 101
4.4.1. Uvod .......................................................................................................................... 101
4.4.2. Kreiranje strukture modula ....................................................................................... 101
4.4.3. Modifikovanje manifest fajla .................................................................................... 101
4.4.4. Dodavanje rute .......................................................................................................... 102
4.4.5. Kreiranje kontrolera .................................................................................................. 103
4.4.6. Kreiranje Pogleda...................................................................................................... 103
4.4.7. Dodavanje novih fajlova u projekat .......................................................................... 103
4.4.8. Aktivacija modula ..................................................................................................... 104
4.4.9. Korišćenje modula .................................................................................................... 104
4.5. Pakovanje i deljenje modula ............................................................................................ 105
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 5
1. Prvi koraci u Orchardu
1.1. Instaliranje Orchard-a
Postoje 4 nacina na koje mozete instalirati Orchard.
Instalirati ga uz pomoc Microsoft Web Platform Installer.
Instalirati ga uz pomoc Microsoft WebMatrix-a kao sto je objasnjeno u Working with
Orchard in WebMatrix.
Skinuti Orchard zip fajl sa neta i instalirati kao sto je objasnjeno u Manually Installing
Orchard Using a zip File.
Selektovati izvorni kod u Orchard-u i napraviti Orchard iz komandne linije ili u Visual
Studiju.
1.1.2. Zahtevi
Minimalni zahtevi za rad Orchard-a su:
* ASP.NET 4 *
Veb server kao sto je IIS Express 7.5 ili IIS 7.x
Napomena: Ako ste prethodno instalirali bilo koje verzije WebMatrix, ASP.NET Web
Pages, ili ASP.NET MVC 3, morate ih prvo izbrisati da bi Orchard pravilno radio na
vasem kompjuteru. Takođe ako planirate da koristite Visual Studio 2010 uz Orchard,
Preporucuje se da pre samog instaliranja Orchard-a, instalirate ASP.NET MVC 3 Tools
Update I to sa Web Platform Installer-a.
Da bi napravili Orchard sajt, mnogi programeri će želeti da koriste bazu podataka SQL server-a i
veb stranicu programskog okruženja kao sto je WebMatrix ili Visual Studio 2010.Predstojeca
instalacija koristeci Web Platform Installer uključuje Orchard i IIS Express 7.5, I takođe
uključuje opcione aplikacije za razvijanje Orchard-a ukljucujuci WebMatrix i SQL Server
Compact 4.0.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 6
1.1.3. Instaliranje Orchard-a
Za početak skinite i instalirajte Web
Platform Installer. Kada je
download gotov pokrenite instaler.
Pronađite Orchard CMS i kliknite
Add da bi izabrali Orchard kao
opciju koju zelite da instalirate. Na
slici se vidi Web Platform Installer
with the ASP.NET MVC 3 Tools
Update koji je vec instaliran i
Orchard koji je selektovan.
Kliknite install. Prihvatite uslove licence da bi nastavili dalje.
Nakon instalacije pojavice se spisak
instaliranih alata kao dodatak Orchard-u.
Kliknite Launch da biste otvorili sajt u
WebMatrix-u.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 7
1.1.4. Pokretanje Orchard-a u web Matrix-u
Kada pokrenete Orchard u vasem
pretrazivacu, videcete Orchard
setup prozor.
Po defoultu, u Orchard-u se nalazi već
ugrađena baza podataka koja se moze
koristiti bez potrebe instaliranja neke druge.
Međutim, ako koristite SQL Server ili SQL
Server Express mozete konfigurisati Orchard
da koristi bilo koju od njih navodeci
konekcioni string. Kao opciju mozete uneti
prefiks tabele tako da vise instalacija
Orchard-a moze deliti istu bazu podataka dok
svoje podatke drži odvojeno.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 8
1.2. Ručno instaliranje Orchard Zip fajla Ukoliko ne želite da koristite Microsoft Web Platform instaler da bi instalirali Orchard, mozete
skinuti zip fajl koji sadrži sve sto vam je potrebno da bi koristili Orchard. Ova tema pokazuje
potrebne korake za instalaciju Orchard-a uz pomoc Zip fajla.
Napomena:Ako planirate da koristite Visual Studio 2010 da bi napravili Orchard sajt,
preporucujemo vam da instalirate Visual Studio i ASP.NET MVC 3 Tool Update, pre nego sto
instalirate Orchard.Ako planirate da koristite WebMatrix da bi napravili Orchard sajt pozeljno je
pogledati temu Installing Orchard. Takođe ako imate prethodno instaliranu bilo koju verziju
WebMatrix-a, ASP.NET web ili ASP.NET MVC 3 morate ih izbrisati ili se apgrejdovati na
najnovije verzije jer u suprotnom Orchard nece pravilno raditi.
1.2.1. Skidanje .zip fajla
Websajt se nalazi u “Orchard” folderu koji se nalazi u .zip fajlu. Mozete pokrenuti skinut
Orchard sajt koristeci IIS, WebMatrix i IIS Express ili Visual studio I Visual studio Development
Server. Sajt je uveliko zavrsen I moze se pokrenuti.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 9
1.2.2. Pokretanje sajta koristeći IIS
Da bi koristili IIS, ekstraktujte sadrzaj Orchard foldera iz .zip fajla u IIS virtualni direktorijum(
ili pocetak sajta) I onda pogledajte sajt koristeci pretrazivac. Ukoliko koristite II7 konfigurisite
ga da radi u integrisanom modu i konfigurisite sadrzaj aplikacije da bi pokrenuli .NET
Framework 4.
Mozda ce biti potrebno da podesite WRITE/READ dozvolu za akaunt koji je konfigurisan kao
identitet za IIS aplikaciju u sledecim folderima:
Moduli. Ovo je neophodno ako zelite da nstalirate module iz galerije.( preporucujemo da
izbrisete READ/WRITE dozvole koje se odnose na production sajt)
Teme. Ovo je neophodno ako zelite da nstalirate module iz galerije.( preporucujemo da
izbrisete READ/WRITE dozvole koje se odnose na production sajt)
AppData_. Ovo je folder u kome Orchard cuva podesavanja.
Media. Ovo je folder u kome Orchard cuva mediju.
Ukoliko zelite da kompletno resetujete Orchard sajt konfiguraciju na defolt podesavanja mozete
izbrisati
AppData_.direktorijum. Ovo brise sva custom podesavanja, korisnike, I konfiguracije. Ako
izbrisete AppData_folder i custom fotografije postavljene na sajt mozete izbrisati media folder.
1.2.3. Pokretanje sajta koristeci WebMatrix i IIS Express
Da bi koristili WebMatrix i IIS Express,
ekstraktujte .zip fajl u lokalni folder.
Pokrenite WebMatrix I u QUICK START
prozoru kliknite na SITE FROM FOLDER.
Uđite u direktorijum gde ste ekstraktovali
.zip fajl I izaberite folder Orchard nakon
toga kliknite SELECT FOLDER da bi
otvorili sajt.
Da bi pokrenuli sajt u WebMatrix FILES
radnom okruzenju selektujte root Orchard
foldera. Kliknite na DROP-DOWN listu na
dugmetu RUN I izaberite pretrazivac.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 10
1.2.4. Pokretanje sajta koristeci Visual studio i Visual Studio Development Derver
Da bi pokrenuli sajt u visual Studiju,
ekstraktujte potpuni izvorni kod .zip
fajl u lokalni folder. Pokrenite Visual
Studio File > Open >
Project/Solution. Uđite u
direktorijum gde ste ekstraktovali .zip
fajl
I otvorite folder sa imenom src.
Selektujte Orchard.sln solution fajl.
Da bi pokrenuli sajt pritisnite F5.
1.2.5. Podesavanja sajta
Kada prvi put pokrenete Orchard sajt
videcete Orchard setup prozor.
Po defoltu Orchard sadzri vec
ugrađenu bazu podataka koja se moze
koristiti bez instaliranja nekih dodatnih
servera. Međutim, ako koristite SQL
Server ili SQL Server Express mozete
konfigurisati Orchard da koristi bilo
koju od njih navodeci konekcioni
string. Kao opciju mozete uneti prefiks
tabele tako da vise instalacija Orchard-
a moze deliti istu bazu podataka dok
svoje podatke drzi odvojeno.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 11
1.3. Rad sa Orchard-om u webMatrix-u
Tokom instaliranja Orchard-a koristeci
Web Platform installer v3, imate opciju da
instalirate na WebMatrix umesto IIS-a.
WebMatrix je najnoviji Majkosoftov alat
koji sadrzi sve potrebno za pravljenje
sajta.Omogucava vam kreiranje,
editovanje I objavljivanje sajtova bez
nekih velikih napora. WebMatrix sadrzi
ugrađen server(IIS Express) zajedno sa
jednostavnim editorom kao I Orchard.
1.3.1. Instaliranje I pokretanje WebMatrix-a
Da bi instalirali WebMatrix skinite I pokrenite Microfost Web Platform Installer. A onda kliknite
ADD dugme za Microsoft WebMatrix I kliknite install.
Prihvatite uslove licence I pokrenite WebMatrix kada se instalacija zavrsi.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 12
1.3.2. Instaliranje Orchard-a unutar webMatrix-a
Da bi pokrenuli Orchard kroz WebMatrix,
kliknite na SITE FROM WEB GALLERY
na pocetnoj strani WebMatrix-a. Pomerite
mis na dole I izaberite Orchard CMS I
kliknite NEXT.
Kliknite na prihvatam EULA sporazum.
Nakon instaliranja pojavice se poruka koja
glasi da ste uspesno zavrsili instaliranje.
Kliknite OK I vas Orchard sajt je otvoren
u WebMatrix-u.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 13
1.3.3. Pokretanje Orchard sajta prvi put
Kada prvi put pokrenete
vas sajt Orchard zahteva od
vas da unesete neke
osnovne informacije o
sajtu.
Da bi pokrenuli Orchard
sajt kliknite na dugme
RUN.
Unesite informaicje I
kliknite na FINISH
SETUP.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 14
1.3.4. Rad sa fajlovima
Mozete koristiti WebMatrix da bi editovali vase fajlove u vasoj Orchard instalaciji. WebMatrix
omogucava jednostavan editor koji uključuje razne opcije za HTML,CSS,Javascript.
Iako ne omogucava ugrađen
sistem za kompajliranje
kodova, sam Orchard
omogucana dimacko
kompajliranje kada su fajlovi
izeditovani.
1.3.5. Rad sa bazom podataka
Nakon sto zavrsite sa instalacijom
I poprvi put pokrenete vas
Orchard sajt, on je konfigurisan
za rad sa bazom podataka. Ako
izaberete SQL COMPACT za
bazu podataka u Orchard setup-u
mozete otvoriti radni prostor baze
podataka u WebMatrix-u kako bi
videli SQKL Server Compact
tabele baze podataka.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 15
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 16
1.3.6. Objavljivanje vaseg Web sajta
Kada želite da objavite vas sajt na
interentu kliknite na PUBLISH dugme u
WebMatrix-u
Da bi objavili sajt na internetu morate
imati account sa web hosting
provajderom.Ukoliko nemate kliknite na
na FIND WEB HOSTING. Nakon sto
postavite vas account na nekom hosting-
u provajder ce vam poslati na mejll
adresu tipicne podatke kao sto su user
name, server name I ostale informacije
koje ce se nalaziti u PUBLISH
SETTINGS opciji. Takođe postoji opcija
gde vam provajder moze poslati “Profile
XML” fajl koji sadrzi informacije koje
se mogu ibaciti kroz opciju IMPORT u
suprotnom morate rucno unositi
informacije.
Ako ste vec objavili sajt moracete da napravite male izmene I da ga ponovo objavite.
1.4. Rad sa vašim prvim Orchard sajtom Ovaj opis daje koje Orchard moze da ponudi pod uslovom da je kao korak-po korak vodic. Ako
je ovo vas prvi put da koristite Orchard ovo je dokument za vas.Ova tema podrzumeva da ste vec
instalirali Orchard I podesili sve potrebne opcije.
1.4.1. Prilagođavanje pocetne stranice Orchard-a
Kada ste prijavljeni kao administrator,na pocetnoj stranici cete primetiti razlicite zone koje mogu
da sadrze razliciti sadrzaj. Drzeci pokazivac misa iznad bilo koje od ovih zona sa klikom na edit
link mozete da izmenite sadrzaj zone. Kliknite na EDIT link za glavnu zonu pocetne
strane.Orchard prikazuje EDIT PAGE prozor.
Velicina slike bi trebala da bude domenzija 200px X 150px. Kliknite na SAVE da bi sacuvali
postavku.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 17
1.4.2. Dodavanje nove stranice na vas sajt
Sledece je dodavanje nove strane na vas sajt. Kliknite DASHBOARD link na kraju pocetne
strane.
U Orchard tabli pod NEW kliknite na opciju PAGE.Nakon toga prikazuje se prozor The
CREATE PAGE.
Popunite podatke za novu stranicu.Kada unesete naslov za stranicu(npr”download”) permalink je
automatski popunjen URL.Mozete izmeni ovaj link ako zelite drigaciji URL.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 18
Dodajte neki sadrzaj na stranicu I popunite ostale opcije kao sto su tagovi I komentari. U TAG
poljima dodajte tagove koji su razdvojeni zarezima kao sto su “Download” I “Orchard” kako bi
ih posle pronasli uz filtriranje.Ako izaberete SHOW ON THE MAIN MENU polje za potvrdu
mozete ubaciti MENU tekst koji bi koristili na pocetnoj strani sajta.
Kada zavrsite sa popunjavanjem nove stranice kliknite na PUBLISH NOW da bi je
objavili.Takođe mozete sacuvati stranicu kao DRAFT sto znaci da je mozete objaviti kad
pozelite.Sada kliknite na YOUR SITE link u gornjem levom uglu tabele. Ovo vas vraca na vasu
pocetnu stranicu kako bi videli izmene na sajtu.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 19
Primetite da je Downloads tab dodan glavnom meniju I da se moze kliknuti kako bi videli
stranu.Takođe uocite da vasa nova strana ima drugaciji izgled od glavne strane. Orchard
omogucava opciju da se sve stranice razlikju jedna od druge
1.4.3. Dodavanje Blog-a na vas sajt
Sada je na redu dodavanje Blog-a.Vratite se na tabelu Orchard-a I kliknite BLOG. Orchard ce
prikazati sledeci prozor: CREATE NEW BLOG
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 20
Dodajte naslov ,opis I meni tekst za blog I kliknite na dugme sacuvaj. Stranica za upravljanje
blog-a prikazuje:
Kliknite na NEW POST da bi kreirali novi blog.Prikazuje se sledeci prozor
Kreiranje bloga je gotovo isto kao I kreiranje stranice. Dodajte neke informacije kao što su
naslov,tekst, link i ostali sadrzaj.Takođe dodajte tagove(odvojene zarezom). Obratite paznju da je
CHECK BOX ALLOW NEW COMMENTS ukljuceno po defoltu.Kada zavrsite sa editovanjem
kliknite SAVE.U tabeli kliknite na MANAGE BLOG da bi videli postove u vasem blogu.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 21
Kliknite na OUR BLOG tab na pocetnoj stranici.Ovog puta, vidite da je blog dodan meniju I da
prikazuje ono sto ste uneli.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 22
1.4.4. Upotreba komentara i tagova(oznaka)
Da bi videli vise informacija o ovome kliknite na
MORE link. S obzirom da ste omogucili komente na
temu sada mozete da unesete vas komentar.
Orchard omogucava i “neku vrstu” “upravljanja”
komenitma u obliku moderatora. Vratite se na Orchard
tabelu i ispod opcije SETTINGS kliknite na
COMMENTS.Primeticete opciju koja sluzi za
odobravanje komentara od strane administratora pre
nego sto se koment prikaze kao I opciju protiv SPAM-
a.
Orchard omogucava sposobnost pretrage sadrzaja uz
omoc tagova koje definisete prilikom kreiranja
sadrzaja.Kliknite na jedan od tagova npr(“Orchard”)
da bi videli potpunu listu sadrzaja sa tim tagom.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 23
Napomena: Ako “smanjite” URL na samo /TAG/ deo mozete videti listu dostupnih tagova na
vasem sajtu.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 24
1.4.5. Izbor Teme
Verovatno zelite da prilagodite izgled I sam “osecaj” vaseg sajta . Na Orchard tabli kliknite na
dugme THEME I prikazace se prozor sa temama.Takođe mozete da instalirate nove teme.Da bi
to uradili idite na tab GALLERY I instalirajte dodatne teme a zatim se vratite na instaliran
tab.Nakon sto je tema instalirana pojavljuje se kao opcija u AVAILABLE Section-u( Trenutna
tema je The Theme Machine )
Orchard omogucava lako “prelistavanje” svih tema. Nakon sto izaberete zeljenu temu kliknite na
SET CURRENT da bi je postavili na vas sajt
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 25
1.4.6. Prosirenje Orchard-a sa Modulima i ostalim karakteristikama
Kljucna karakteristika Orchard-a je da doda nove funkcije u cilju da prosiri funkcionalnost vaseg
sajta. Osnovni nacin da se to uradi je da se instaliraju moduli. Modul mozete videti kao skup
foldera u.zip fajlu koji se moze instalirati na vas sajt.Da bi videli Module koji se nalazu u
Orchard-u, u Orchard tabli kliknite MODULES a zatim kliknite na tab INSTALLED TAB u
MODULES prozoru.
Orchard omogucava vec instalirane modula. A vi mozete instalirati dodatne po zelji. Za detalje
pogledajte instaliranje I nadogradnja Modula. Pojedini Moduli mogu imati karakteristike koje se
nezavisno mogu ukljuciti ili iskljuciti
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 26
1.4.7. Rad u okviru kontrolne table ( Dashboard-a )
Orchard-ova tabla vam omogucava da upravljata vasim sajtom, menjate izgled, dodate novi
sadrzaj kao I da omogucite I onemogucite sadrzaj Orchard-a. Kada ste prijavljeni na vas sajt
mozete da pristupite tabli klikom na link na kraju vase pocetne strane.Kada otvorite kontrolnu
tablu mozete videti listu primene funkcija kao I podesavanja na levom delu stranice.Lista je
podeljena na delove srodnih funkcija.Svaki prosirivi odeljak se moze se moze sazeti kako bi
pokazao sadrzaj sekcije.ako kliknete naslov odeljka prva karakteristika je odabrana. Ova lista se
menja dok omogucavate I onemogucavate funkcije Orchard-a. NPR blog sekcija ce imati set
dodatnih stvari ispod nje (kao na slici)nakon sto napravite blog.Nova sekcija vam omogucava da
kreirate nove slicajeve podrazumevane tipovima sadrzaja, kao I bilo koji prilagođeni tipovi
sadrzaja koje vi definisete. Desna strana stranice prikazuje podesavanja koja su dostupna za
izabranu funkciju.Sledece slika prikazuje sadrzaj na kontrolnoj tabli.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 27
Sekcija Opis
Dashboard Contains the dashboard and displays the main ("Welcome to Orchard") page. This page contains a number of
helpful links for working with Orchard. The page also shows the Orchard version that is running, and
displays advisories from http://orchardproject.net (when advisories are available) that can notify you when a
new version is available or when an important update needs to be applied.
New Lets you create new instances of default content types or of custom content types that you define in
theContent => Content Types screen. For more information, see Creating Custom Content Types.
Blog Lets you add a blog to your website, create new blog posts, and manage your blog. For more information,
seeAdding a Blog to Your Site.
Content Lets you add new pages, edit or remove existing pages, and publish pages. This is also where you can create
and manage your own content types if you have enabled that feature. For more information, see Adding
Pages to Your Site and Content Types.
Comments If your website is configured to allow users to post comments, lets you manage the posted comments. For
more information, see Moderating Comments.
Widgets Lets you manage the widgets that appear on the pages of your site. For more information, see Managing
widgets.
Media Lets you add or remove folders that contain media. For more information, see Adding and Managing Media
Content.
Navigation Lets you add or remove items in the main menu and define additional navigation menus. For more
information, see Navigation and Menus.
Tags Lets you add or remove content tags for your site. For more information, see Organizing Content with Tags.
Modules Lets you download, install, and manage modules and features on your site. For more information,
seeInstalling Modules and Themes from the Gallery, Enabling and Disabling Features, and Installing and
Upgrading Modules.
Themes Lets you install new themes and apply themes to your site. For more information, see Installing
Themes andPreviewing and Applying a Theme.
Users Lets you manage users and roles for your site. For more information, see Managing Users and Roles.
Reports Lets you manage and view reports that Orchard generates for your site.
Settings Lets you configure a variety of site settings such as the site name and culture, the default number of items
per page, URLs for Gallery feeds, whether user-added comments must be approved, media file types that
can be uploaded, and user registration settings. For more information see Modifying Site Settings.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 28
1.5. Dodavanje stranica na vas sajt Nakon sto napravite sajt u Orchard-u, potrebno je da dodate stranice na vas sajt sa zeljenim
sadrzajem. Ova tema pokazuje kako da dodate novu WEB stranicu, dodate sadrzaj koristeci
Orchard-ov TEXT EDITOR I sve to objavite na vas sajt.
1.5.1 Kreiranje nove stranice
U Admin delu pod opcijom CONTENT kliknite CREATE PAGE. Nakon toga pojavljuje se
prozor kao na slici
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 29
Koristeci opciju NEW PAGE mozete koristiti sledece:
Dati novoj stranici naslov.
Dodati SEARCH opciju.
Videti novu stranicu kao pocetnu stranicu sajta.
Dodati sadrzaj koristcei TEXT EDITOR.
Dodati TAG-ove.
Navesti da li dase pokaze stranica u glavnom meniju.
Odobriti komente od strane korisnika.
Dodeliti vlasnika stranice.
Sacuvati I objaviti stranicu na sajt.
1.5.2. Linkovi
Link je URL koji pokazuje adresu stranice. Pogledajte sledecu sliku
1.5.3. Tagovi sa sadrzajem
Sadrzaj znaka dodeljuje kategorije sadrzaja na ovu stranicu. Npr stranica o poznatim autorima
fantastike moze imati sledece tagove:autori, fikcija I knjige.Nakon sto je stranica
objavljena,spisak stranica sa oznakama se nalazi ispod dela sa sadrzajem. Klikom na ovaj
TAG(oznaku) koriskin moze lako pronaci ove stranice.
1.5.4. Prikazi na glavnom meniju
Ako zelite da se link za neku sranicu nađe na glavnom meniju izaberite SHOW ON MAIN
MENU check box.Kada je ova opcija selektovana MENU TEXT opcija ce biti prikazana I
mozete uneti tekst.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 30
1.5.5. Komentari od strane korisnika
Komenti se ne odobravaju po defoltu na stranicama. Da bi ih odobrili idite na opciju Content ->
Content Types I promenite sadrzaj stranice I onda dodajte COMMENTS deo.
Da bi omogucili korisnicima da postavljau komente izaberite ALLOW NEW COMMENTS I
forma ce biti dodata na kraju stranice za komente od strane korisnika. Na sledecoj slici se to I
vidi.
1.5.6. Kako koristiti RICH-TEXT editor
Orchard tekst editor vam omogucava da dodate sadrzaj na vasu stranicu koristeci svoje mocne
opcije Sledeca slika prikazuje alat bar sa svakim dugmetom I oznakom.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 31
1.5.7. Cuvanje i objavljivanje stranice
Na slici se vidi nacin cuvanja I objavljivanja gotove stranice na vas sajt.
1.6. Navigacija I meniji Orchard ima veoma jednostavnu funkicju koja se odnosi na glavni meni koja je spisak teksta
stavke menija I linkove koji se mogu prikazati. Kada dodate stavku u glavnom meniju koristeci
sytranicu ili blog novi deo je postavljen ovde. Mozete vrsiti izmene tipa da preimenujete,
preuredite I uklonite stavke menija.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 32
1.7. Dodavanje bloga na vas sajt Orchard omogucava blogging opciju koja je veoma jednostavna za dodavanje bloga na vas sajt.
Ova tema opisuje kako napraviti blog I postaviti ga na vas sajt.
1.7.1. Kreiranje novog bloga
U panelu Admin-a ispod BLOGS, kliknite na CREATE NEW BLOG I podesavanja ce se
prikazati ka na slici
Koristeci CREATE NEW BLOG opciju mozete uraditi sledece:
Dati novom blogu naslov.
Dodati permalink na blog.
Postaviti blog kao pocetnu stranicu sajta.
Dodati opis koji ce biti prikazan na vrhu bloga kada bude objavljen.
Dodati tagove.
Da li ce blog biti prikazan na glavnom meniju
Dodati vlasnika blog-a.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 33
1.7.2. Kreiranje novog blog post-a
Cim je blog dodat na vas sajt, mozete dodati blog post-ove. Na sledeco slici se upravo to I vidi.
Koristeci CREATE NEW POST BLOG opciju mozete uraditi sledece:
Dati novom post blogu naslov.
Dodati permalink na post blog.
Postaviti post blog kao pocetnu stranicu sajta.
Dodati opis koji ce biti prikazan na vrhu post bloga kada bude objavljen.
Dodati tagove.
Da li ce post blog biti prikazan na glavnom meniju
Dodati vlasnika post blog-a.
Sacuvati I objaviti post blog.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 34
1.8. Dodavanje i organizovanje medijskih sadržaja Kada upload-ujete slike koristeci rich text editor u Orchard-u sve slike se cuvaju u MEDIA
folderu koji je se nalazi u samom “korenu” Orchard instalacije.MEDIA folder mora da bude
WRITABLE da bi se slike upload-ovale na sajt. Ako ste instalirali Orchard preko Web Platform
Installer-a dozvole MEDIA foldera su automatski podesene. Da bi dodali I brisali MEDIA
foldere kliknite MEDIA u dashboard-u.
Svojstva medijske datoteke su:
Screenshot. preview sadrzaja slike.
Size and Added on. Svojstva medija fajla..
Embed. URL medija fajla.
Name. Naziv medija fajla.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 35
Da bi upravljali poddirektorijumom za vas medija folder ponovo kliknite na dashboard
(tablu).Zatim kliknite na folder da bi se prikazao MANAGE folder prozor.
Ovaj prozor vam daje opcije da dodate ili brisete media fajlove I da kreirate podfoldere.
Kliknite na dugme dodaj folder da bi kreirali novi podfolder. Dajte naziv novom podfolderu npr
“Slike”.
Pretrazite novi podfolder I kliknite ADD MEDIA.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 36
Orchard vam omogucava da pojedinacno upload-ujete medija fajlove ili zapakovane u .zip fajl
koji ce sadrzati vise slika. Ukoliko imate veliki brojslika koje bi postavili na sajt, najbolja opcija
je zapakovati ih u zip fajl pa tek onda u toj extenziji upload-ovati na sajt. Da bi videli kako to
radi napravite .zip fajl I kliknite na UPLOAD . EXTRACT zip opcija je ukljucena po defoltu
koja ce ih sve raspakovati.
Upload-ovane I ekstraktovane slike se nalaze u PARENT folderu
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 37
Da bi izmenili podatke pojedinacnih slika kliknite na njih.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 38
1.9. Upravljanje widgets-ima U Orchard-u, widget je fragment korisnickog interfejsa (kao sto je HTML) I kod (kao sto je deo
sadrzaja) koji se lako mogu mapirati prema bilo kojoj lokaciji u aktivnoj temi kao sto su sidebar
ili footer zona.Primeri WIDGET-a ukljucuju navigaciju menija, galerije slika, oglasi, video
itd…
Ovaj clanak objasnjava osnove widget-a.
1.9.1. Slojevi,Zone I Widget-i
U Orchard-u koristite
widget-e klikom na
na WIDGET na
kontrolnoj tabli.
Ekran widgeta vam
izlistava dostupne
widget-e I omogucava
vam da ih postavite u
koju god zonu ili sloj
zelite.Mozete
zamisliti da je SLOJ
skup pravila za
prikazivanje widget-a
(ili grupa
widgeta).NPR sloj
moze da prikaze
određeni widget na
određenoj stranici
jedino ako je korisnik
ulogovan. Naredna
slika pokazuje ekran
widget-a.
1.9.2. Dostupni widget-i
Kad god widget postane dostupan(obicno tako sto omogucava jos neku od karakteristika na tabu
funkcija I to na ekranu Moduli kontrolne table.Orchard dodaje na listu dostupnih widget-a koji se
mogu dodati u trenutnoj zoni sa aktivnom temom. Da bi videli listu dostupnih widget-a u zoni, u
WIDGET ekranu, kliknite ADD dugme na izlistanim zonama.Npr na ekranu widget-I kliknite na
dugme dodaj za HEADER zonu.Prikazuje se ekran koji vam omogucava da izaberete jedan od
dostupnih vidzeta.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 39
1.9.2. Lista Lejera
Orchard u sebi vec ima jedan definisan broj lejera.Mozete definisati dodatne lejere ako je to
potrebno. U ekranu widget-a mozete editovati vec postojeci lejer tako sto cete izabrati taj Lejer u
Lejer padajucem meniju. Ili jednostavno dodati uz pomoc opcije ADD a new layer.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 40
1.9.4. Lista Zona
U Orchard-u web stranica je podeljena na zone(regije).dostupne zone su definisane sa web
temom. U widget ekranu mozete videti sve dostupne zone za trenutno izabrani lejer.Lista takođe
prikazuje koji je widget prikazan za koju zonu. Za infoirmacije koje su dostupne u
podrazumevanoj temi (TheThemeMachine) pogledajte Customizing the Default theme.
1.9.5. Dodavanje Lejera
Da bi dodali lejer u kontrolnoj tabli kliknite na widgets. Na widget ekranu kliknite na ADD a
NEW LAYER. The Add a new layer ekran je prikazan.
Da bi definisali novi
sloj unesite ime sloja,
opis I pravilo da
definise sloj.Kada
zavrsite kliknite na
dugme save. Pravilo
lejera koji odlucuje da
li je tacno ili ne. ako je
tacno widget ce biti
prikazan u suprotnom
nece na sledecoj tabeli
se moze videti sintaksa
za izgradnju pravila
sloja.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 41
1.9.6. Dodeljivanje widget-a na zone
Da bi dodali widget na neku od zona kliknite ADD dugme onde gde zelite dodati widget. Npr
kliknite ADD na Heder zonu I onda u opciji Izaberite widget ekrana kliknite HTML WIDGET.
Prikazuje se ekran.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 42
1.9.7. Izmena ili Brisanje Widget-a
Da bi izmenili ili obrisali widget, u Widget ekranu, upotrebite Current Layer padajucu listu da bi
izabrali lejer koji je dodeljen tom widget-u. U listi zona kliknite na widget koji zelite da
izmenite. Prikazuje se ekran.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 43
1.10. Organizovanje sadrzaja uz pomoć oznaka Sadrzaj stavki se u Orchard-u moze kategorizovati uz pomoc TAG-ova, a listi koja je oznacena
sa kljucnom reci moze se pristupiti preko front end ~tag/tag-name URL . Pretrazivac ce nas
odvesti do trazenog URL-a bas uz pomoc ove opcije.
Da bi izmenili globalne liste na
svom sajtu idite na Manage
Tags ekran u Orchard tabli u
odeljku navigacija.Ovde
mozete da izmenite kljucne
reci ili uklonite oznake. Kada
menjate oznaku ona azurira
sve oznake I sadrzaje sa tag-a
za kljucnu rec.Ovo je veoma
korisno za “ciscenje” vasim
tag-ova kako bi bili konstanti
na vasem sajtu.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 44
1.11 Kreiranje listi
U Orchard-u mozete kreirati sopstveni sadrzaj stavke i dodeliti ga kao “navigacioni meni unosa”.
Ukoliko imate vise od nekoliko sopstvenih stavki sadrzaja, verovatno cete zeleti da ih
organizujete u liste. Ova tema razmatra takve korake. Kroz ova uputstva napravicete sopstveni
sadrzaj I prikazati njegove stavke u listi.( Za informaciju kako napraviti prilagodjeni tip sadrzaja,
pogledajte temu kreiranje sopstvenih tipova sadrzaja)
1.11.1. Kreiranje Sopstvenih Sadrzivih Tipova Vaseg Sadrzaja
Za pocetak, napravicete sosptveni sadrzaj koji ce da predstavlja recenziju knjige.Na kontrolnoj
tabli kliknite na sadrzaj, a zatim izaberite Tab tipovi sadrzaja. Kliknite na dugme kreiraj novi tip
a zatim u polju Display Name unesite naziv “ Recenzija knjige” . Kliknite na dugme CREATE da
bi zavrsili kreiranje novog tipa.
Prikazuje se ekran u kome mozete dodati delove sadrzaja u novokreiranom tipu sadrzaja.
Izaberite CHECK BOX za sve predstojece sadrzaje kako bi ih dodali u novokreiranom sadrzaju.
Body - Dodaje body deo zajedno sa rich-text editorom koji mozete koristiti da pogledate
recenzije
Komentari - Omogucava korisnicima da komentarisu kritike
Zajednicko - Daje svakoj recenziji skup svojstava, ukljucujuci vlasnika, kontejner,
verzije, datum kreiranja, datum izdavanja itd…
Sadrzivost – Ovaj deo govori Orchard-u da stavke ovog tipa mogu biti povezane sa
listom koja omogucava opcije DASHBOARD-A ( kontrolne table ). Jedna od osnovnih
stvari u ovom tutorijalu.
Vazno: Uvek dodajte Common deo kada dodajete i Containable (sadrzivost) deo. U suprotnom
nece biti u mogucnosti da dodate vas sadrzaj na listu.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 45
Putanja - Omogucava brzu-laku putanju ( URL ).
Oznake – Omogucava dodavanje oznaka (tagova) za recenziju knjige.
Kliknite na Save da zavrsite dodavanje vaseg sadrzaja . Ekran za izmenu prikazuje deo sadrzaja
koji ste upravo uneli. Na ekranu koji sluzi za izmenu sadrzaja (Edit Conten Type Screen) kliknite
na Dodaj(Add) pored opcije Fields.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 46
Dodajte svako od sledecih polja tako sto cete uneti ime polja u Add New Field opciji ( bez
razmaka) a zatim kliknite na Save (sacuvaj ).
Buy (Kupi) – Ovo polje oznacava Commerce (kupovni) sajt gde se kjiga moze kupiti.
Verdict (Presuda) – Ovo polje oznacava preporuku za neku knjigu npr “Buy”, “Read” ili
“Skip”.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 47
Nakon sto ste dodali polja, vas sospstveni tip sadrzaja izgleda kao na slici. Kliknite na dugme
Save (sacuvaj ) kako biste sacuvali sopstveni tip sadrzaja.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 48
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 49
Na kontrolnoj tabli prosirite New ( novi ) meni. Videcete recenzije knjige. Nemojte jos uvek
kliknuti New Type na kontrolnoj tabli. Prethodno morate napraviti Book container ( mesto za
recenziju knjige ) u listi a ne kao pojedinacnu stavku.
1.11.2. Kreiranje Liste Knjiga
Da biste kreirali listu knjige u New (novom) menije kontrolne table kliknite na List. Nazovite
novu listu “Book Reviews” I u polju Contains ( sadrzaj ) izaberite “Book Reviews” sa padajuceg
menija. Izaberite Show (pokazi) opciju I unesite “Book Reviews” u polju tekst menija.Kada
zavrsite kliknute Save ( sacuvaj ).
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 50
1.11.3. Kreiranje Stavke Sadrzaja Knjige
Sada mozete poceti da kreirate recenzije knjige. Na kontrolnoj tabli kliknite New Book Review (
Nova recenzija knjige ). Napravite par recenzija knjige I objavite ih.
Add To ( dodajte ). Izaberite listu: Book Reviews sa liste padajuceg menija, kako bi
recenzija bila dodana listi.
Title ( naslov ). Unesite naslov knjige. URL je generisan na osnovu naziva knjige.
Body ( telo ). Sluzi za unos komentara.
Buy ( kupi ). Dodaje URL gde se knjiga moze kupiti.
Verdict ( presuda ). Preporucuje (buy, read, skip).
Tags ( oznake ). Unesite oznake kako bi lakse pronasli ono sto trazite.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 51
1.11.4. Prikazivanje Liste
Da bi videli listu recenzija knjiga vratite se na pocetnu stranicu, a zatim kliknite na stavku New
Book Reviews.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 52
2. Upravljanje sajtom
2.1. Orchard galerija modula S obzirom da je Orchard CMS baziran na modulima, on je dizajniran da bude priširiv
instaliranjem dodatnih modula i omogućavanjem opcija koje se nalaze u tim modulima. Jedan
paket (modul) se sastoji od zipovanog fajla u .nupkg formatu. U Orchard CMS-u, tema je takođe
jedan tip modula. Da bi se olakšalo deljenje modula i tema, Orchard omogućava pretraživanje
modula preko online formi, a instalira ih direktno na vaš sajt.
2.1.1. Odabir modula iz galerije
Ako želite da pronađete odgovarajuće module i skinete ih u vaš računar, potrebno je da posetite
ovaj sajt http://gallery.orchardproject.net/. Na ovom sajtu možete da prođete kroz gomilu
modula kreiranih za upotrebu u Orchard CMS-u kako bi ga proširili i prilagodili svom ukusu. To
je mesto na kome developeri i dizajneri mogu da podele svoje module sa drugima.
2.1.1.1. Moduli
U „Modules“ delu možete da pregledate
dostupne module.
Moduli su raspoređeni u kategorijama, tako
da možete vrlo brzo da nađete odgovarajuće
klikom na link kategorije.
A ukoliko znamo koji nam je modul
potreban, tu je „Search“ opcija, sa kojom
možemo direktno da ciljamo traženi modul.
2.1.1.2. Teme
Ako želimo novu temu, odabraćemo „Themes“
deo, tu će nam se prikazati lista sa temama, slična
kao na stranici sa modulima. Za razliku od
modula, teme nemaju kategorije. Ali i moduli i
teme sadrže oznake koje postavljaju autori, a
klikom na oznaku izlistaće vam se svi moduli koji
imaju tu oznaku.
Kao i za module, možete iskoristiti Search box
kako bi pretražli dostupne teme.
Svaki modul ili tema iz galerije ima deo koji
sadrži detalje o tom paketu, kao što su: slika
teme, verzija paketa, broj preuzimanja,
informacije o licenci ili sajt modula na kome
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 53
možete da saznate nešto više o
modulu. Tu je takođe i
„report abuse“ link na kome
možete da prijavite
nepristojan sadržaj.
2.2.2. Gallery project
Sama implementacija sajta sa modulima se razvija kao open source projekat, a source code je
dostupan na OrchardGallery.CodePlex.com. Ovaj projekat još uvek nije završen, a dosta toga
tek čeka da bude implementirano. Planirano je da u skorije vreme sledeće opcije budu ubačene:
Recenzije i glasanja
Sklapanje svih verzija pod jednom grupom
Prikazivanje ukupne ocene i broja skidanja po svim vezijama paketa
Bolji menadžment i interjfejs za slanje paketa modula.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 54
2.2.3. Instaliranje modula i tema iz galerije
Orchard takođe nudi opciju da instalirate
module i teme direktno sa dashboarda.
Ova opcija je uključena nakon instalacije
Orchard-a, a može se odabrati klikom na
„Gallery“ dugme koje se nalazi pri vrhu
stranice sa modulima u dashboard-u.
2.2.3.1. Instaliranje teme
Kako bismo instalirali temu iz galerije, prvo ćemo da kliknemo na „Themes“ u dashboard-u, a
zatim na „gallery“. Pojaviće se lista sa temama koje sadrže „instal“ i „download“ linkove pored
svake teme.
Nakon instalacije, tema će biti dostupna za biranje na vašem sajtu. Ako prvo skinete paket sa
temom, moraćete da iskoristiite dashboard kako biste instalirali tu temu.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 55
2.2.3.2. Instaliranje modula
Za pristup modulima iz galerije,
kliknite na „modules“ u
dashboard-u, a zatim odaberite
„gallery“ deo. Pojaviće se lista
sa modulima i odgovarajućim
linkovima za download i instal
opcije.
Kao i kod tema, ako instalirate
modul, on će postati dostupan
za korišćenje na vašem sajtu, a
ako samo skinete modul,
morate da ga instalirate ručno,
klikom na link „install module
from your computer“.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 56
2.3. Omogućavanje i onemogućavanje karakteristika Možete dodati funkcionalnost na svoj sajt uz pomoć uključivanja i isključivanja opcija
prikazanih na modulima koji su instalirani u Orchardu. Da biste videli dostupne opcije, kliknite
na “Opcijas” u okviru “Configuration” zaglavlja u Orchard administrativnom panelu.
“Manage features” prikazuje dostupne
opcije koje mogu da se omoguće ili
onemoguće. U zavisnosti od toga koje opcije
su omogućene, sajt će imati različite opcije u
administracionom panelu, front-end
elemente korisničkog interfejsa, kao i druge
opcije. Podrazumevani prikaz raspoloživih
opcija se prikazuje u "Box" pogledu (kako bi
se povećao broj opcija prikazanih na prvi
pogled).
Takođe možete podesiti prikaze na "Lista"
pogled ako više volite da vidite opcije kao
listu stavki sa više opisa.
Da biste omogućili opciju, jednostavno kliknite
na dugme Enable.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 57
Kada je opcija omogućena, pojavljuje se poruka na vrhu “Manage features” strane da je opcija
uspešno omogućena.
Opcija može da bude zavisna od jedne ili više drugih opcija (navedene pod imenom opcije).
Kada je opcija sa koja ima zavisne opcije omogućena, sve zavisne opcije su automatski
omogućene.
Na primer, Galery zavisi od Packaging opcije, koja opet zavisi od Packaging Services.
Omogućavanje Galery će omogućiti Packaging i Packaging Services.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 58
Omogućavanje opcija (kao što je Galery), ce ponekad dodati dodatne stavke u meniju u
administrativnom panelu, kao što je prikazano u prethodnoj slici.
Orchard takođe pruža command-line interfejs, gde takođe mogu da se listaju, omoguće, i
onemoguće opcije. Možete naći command-line u bin direktorijumu aplikacije, a može da se
pokrene iz početka sajta unosom “bin\orchard.exe” u Windows cmd-u. Da bi prikazali dostupne
opcije, ukucajte “feature list” ili “feature list” /Summary:true u cmd-u.
Omogućite opciju iz komandne linije kucanjem “feature enable “feature-name”;
npr: “feature enable Gallery.”
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 59
2.4. Izmena podešavanja sajta Mogu se konfigurisati opšta, globalna, i podešavanja specifičnih funkcija za sajt u Settings
panelu (meni stavki sadržanih u odeljku Settings) u controlnoj tabli.
U Settings panelu na kontrolnoj tabli, podešavanja su
raspoređena u kategorije, uključujući i General, Gallery,
Comments, Media i Users.
2.4.1. Opšta podešavanja
Da biste pristupili opštim podesavanjima izaberite stavku
General u panelu Settings, kao što je prikazano na slici
levo.
U General Setings delu može se modifikovati sledeća
globalna podešavanja:
Site name. Ime vašeg sajta
Default Site Culture. Lokalitacija
sajta
Page title separator. Znak koji se
koristi za razdvajanje sekcija od
naslova stranica.
Super user. Korisnik koji ima
administrativna prava sajta, bez
obzira na podešene role. Ovo je
uglavnom korisnik koji je instalirao
Orchard, a to je admin.
Resource Debug Mode. Mod koji
određuje da li su skripte i stilovi
učitani u “debuggable” formi ili u
njohovoj osnovnoj formi
Default number of items per page.
Na stranicama koje mogu da prikažu
više stvari (kao što je blog stranicu sa
blog postovima), podrazumevani broj
stavki koje su prikazane po strani.
Baze URL. Bazni URL sajta.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 60
2.4.2. Podešavanja galerije
Za pristup galeriji, kliknite Gallery i Settings panelu. Otvoriće se sledeći prikaz:
U “gallery feed” podešavanjima može se dodati ili izbrisati feed
1 koristeći sledeća podešavanja:
Add Feed. Omogućava vam da odredite URL za feed.
Delete. Omogućava vam da uklonite postojeći feed.
2.4.3. Podešavanje komentara
Da biste pristupili podešavanjima za komentare, kliknite Comments na panelu Settings. To
otvara sledeći prikaz:
U podešavanjima komentara, mogu se omogućiti ili onemogućiti sledeće funkcije:
Komentar mora biti odobren pre nego što se pojavi. Zahteva da komentar korisnika
bude odobren od strane administratora ili moderatora pre nego što postane vidljiv na
sajtu.
Omogućavanje spam zaštite. Automatski prepoznaje spam komentare i obelezava ih za
pregled.
1 Izvor kolekcije modula za galeriju
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 61
2.4.4. Podešavanje medija Da biste pristupili podešavanjima koji se tipovi fajlova mogu biti upload-ovati, kliknite Media u
panelu Settings.
U podešavanju medija, mogu se odrediti sledeće opcije:
Media. Lista dokumenata koji se mogu uploadovati2 (na primer, jpeg gif png txt doc docx xls
xlsx).
2.4.5. Podešavanje korisnika
Da biste pristupili podešavanjima korisnika, kliknite Users u panelu Settings. To otvara sledeći
prikaz:
U korisničkim podešavanjima, mogu se omogućiti ili onemogućiti sledeća podešavanja za
registraciju korisnika:
Korisnici mogu da kreiraju
nove naloge na sajtu. Omogućava
korisnicima da prave nove naloge
Prikazivanje linka korisnicima
da resetovanje lozinke. Pruža
korisnicima način da resetuju svoje
lozinke.
Korisnici moraju da potvrde
svoju e-mail adresu. Zahteva od
korisnika da potvrde svoj e-mail adresu
prilikom registracije.
Korisnici moraju biti odobreni
pre prijavljivanja. Zahteva
administrativno odobrenje novih naloga pre nego što korisnici mogu da se prijave.
2 Otpremiti
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 62
2.5. Uređivanje komentara Comments funkcija pruža mogućnost da praćenja i upravljanja komentarima za stavke sadržaja
na sajtu. Ova tema opisuje dva seta alata koji omogućava Orchard za rad sa komentarima na
sajtu: alatke za upravljanje postojećih komentara, i podešavanja globalnih svojstva komentara.
2.5.1. Upravljanje komentarima
Da biste pristupili upravljanju komentarima, kliknite Comments na Orchard kontrolnoj tabli.
Comments ekran lista komentare na svim sadržaima vašeg sajta. On takođe može da prikaže
filtrirani spisak koji pokazuje sve komentare po administrativnim kategorijama ("na čekanju",
"odobreno", ili "spam"). Ako želite iskoristite akciju koja se odnosi na više komentara, izaberite
komentare koje želite, a zatim koristite padajuću listu za primenu akcije kao što su Approve3 ili
Unapprove4.
Ukoliko želite da podesite komentare za specifični sadržaj, kao što je stranica ili blog post,
kliknite na edit, a u edit modu ćete naći opciju da prikažete komentare za tu stavku.
3 Dozvoli
4 Odbaci
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 63
Na ekranu Comments, kliknite na
Edit pored odobrenog komentara.
Ekran za uređivanje komentara se
prikazuje.
Kliknite Pending da promenite
status komentar, a zatim sačuvajte
komentar. Pretražite vaš sajt i
pogledajte sadržaj stavke za koju
ste promenili u kategoriju "na
čekanju". Komentar više nije
vidljiv.
Komentare možete podeliti u
sledeće kategorije:
Pending. Komentar čeka
odobrenje administratora.
Komentar neće biti vidljiv za
korisnike ukoliko ga administrator
ne označi kao "Odobreno".
Approved. Komentar je odobren i da će se pojaviti na sajtu. Ovo je podrazumevana kategorija za
nove komentare osim ako omogućiti sajt nivou podešavanje da traži odobrenje svih komentare.
(Vidi sledeći odeljak).
Mark as spam. Komentar je spam i neće prikazati.
2.5.2. Opšta podešavanja komentara
Orchard obezbeđuje dve mogućnosti komentara: administrativno odobrenje komentara i spam
zaštitu. Ovim funkcijama može se pristupiti klikom na Settings> Comments. Pojavljuje se ekran
na kontrolnoj tabli za opcije podešavanja komentara.
2.5.2.1. Zahtevanje odobravanja komentara
Možda ćete želeti zahtev za odobrenje komentara pre nego što postanu vidljivi na sajtu. Kao i
prethodna ilustracija za prikazivanje uređivanja komentara, po defaultu, komentari su odobreni i
vidljivi. Međutim, ako je aktivirano podešavanje gde se traži odobrenje komentara, novi
komentari biće "na čekanju" i neće biti prikazani dok ne budu odobreni.
Za trazenje odobrenje komentara, kliknite na dugme Settings>Comments na kontrolnoj tabli.
Pojavljuje se ekran za podešavanje upravljanja komentarima na sajtu.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 64
Odaberite Comments must be approved before they appear i sačuvajte podešavanje. Nakon
što ste omogućili ovo postavku, moraćete da pregledate sve nove komentare korisnika na ekranu
Comments, kao i za komentare koje želite da omogućite na sajtu, promenite njihov status iz
"pending" u "approved"
2.5.2.1. Omogućavanje zaštite od spama .
Funkcija zaštita od spama pomaže da se automatski svrstaju neki komentari kao spam, tako da se
može sprečiti da budu prikazani na sajtu.
Za sprovodjenje zaštite od spama, Orchard koristi Akismet spam zaštitu, koja razmatra
komentare, kada se postave. Kada Akismet detektuje komentar koji odgovara kriterijumima za
spam, on automatski ga dodeljuje Mark as Spam kategoriji.
Da biste omogućili funkciju Akismet spam zaštita na sajtu, uradite sledeće:
Nabavite Akismet key iz Akismet.com.
Kliknite na Settings> Comments na kontrolnoj tabli, a zatim izaberite Enable spam
protection
Unesite Akismet ključ u ovo polje.
Dodajte URL adresu vašeg Orchard sajta
Sačuvajte podešavanje
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 65
Nakon što omogućite spam zaštitu, možete koristiti Comments prikaz da izaberete komentare
koji su označeni kao spam, pregledate ih i izbrišete komentare koji stvarno jesu spam.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 66
2.6. Upravljanje sa korisnicima i ulogama Orchard pruža mogućnost za upravljanje korisnicima i ulogama za sajt, korisnicima kojima je
dodeljena jedna ili više uloga, kao i različitim dozvolama za svaku ulogu.
Da biste upravljali korisnicima na svom sajtu, kliknite Users link u admin
panelu.
Po defaultu5, postoji samo jedan korisnik, a to je admin koji je podesio
instalaciju Orcharda. Za dodavanje drugih korisnika, kliknite na Add a new user. Možete da
menjate, brišete i suspendujete korisničke naloge iz ovog prikaza.
Kada se dodaje novi korisnik, navede se
korisničko ime, email adresa i lozinka, zajedno sa
jednim ili više uloga za korisnika. Uloge odredjuju
koje dozvole korisnik ima na sajtu, drugim rečima,
one operacije koje su mu dozvoljene da obavi.
Dozvole mogu samo da dodaju mogućnosti
korisniku, ali nikada ne mogu da oduzmu.
Takođe možete da konfigurišete
uloge na svoj sajt klikom Roles
linka u admin panelu.
5 Podrazumevana vrednost
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 67
Po defaultu, Orchard uključuje niz uloga sa podrazumevanim dozvolama:
Administrator - može da obavlja bilo koju operaciju (ima sve dozvole)
Editor – Može da dodaju, objavljuju i uređuju svoje i tuđe sadržaje.
Moderator- Može da uredjuje komentare i oznake. Ne može biti autor.
Author – Imaju autorske dozbole, objavljuju i uređuju svoje stavke sadržaja
Contributor - Može da uredjuje svoje sadržaje, ali ne i da ih objavi (save draft only)
Anonymous – može da vidi samo front-end6 u sajtu.
Authenticated - mogu da vide sajt front-end, i vrši druge operacije u zavisnosti od ostalih
dozvola.
6 Prednji deo sajta
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 68
Da biste izmenili dozvole za datu ulogu, kliknite na Edit pored uloge imena.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 69
3. Kreiranje teme Tema Orchard definiše izgled aplikacije i koristi se da se prilagodi izgled i efekat Orchardovog
web sajta. Temom mogu da se promene stil, slike, izgled ili sadržaj šablona koje pruža Orchard
modul. Uz to, tema može sadržati kod koji menja ciljni kod u modulu.
3.1. Writing a new Theme: Ovaj članak pokazuje kako da se stvori tema brisanjem podataka. Namenjen je da bude uvod u
razvoj teme i održava se jednostavnim, putem dizajna.
Umesto da se počne od brisanja, možete napraviti temu prilagođavanjem postojeće teme
(roditeljska tema). Orchard obezbeđuje temu koija se zove "TheThemeMachine" koja je
dizajnirana kao lako upotrebljiv roditelj za prilagođavanje teme.
3.1.1. Generating a new Theme:
Komandnu liniju ne možete da počnete da koristite pre nego što date komandu codegen da bi ste
stvorili strukturu koda za vašu novu temu, morate da učitate i osposobite Code
Generation7 karakteristiku. Ova karakteristikja nije, po pravilu, instalirana na Orchard. Da bi se
generisala struktura koda za novu temu, otvorite komandnu liniju Orcharda i ukucajte sledeću
komandu:
- codegen theme MyFirstThem
Codegen komanda stvara strukturu koda za novu temu i postavlja ime teme u MyFirstTheme.
Komanda proizvodi sledeću strukturu foldera:
Jedini fajlovi koji su stvoreni su Theme.txt i Views\Web.config. Theme.txt fajl prikazuje ime teme
i na tom mestu Admin Panel (dashboard) traži informaciju o nazivu teme. Web.config je
konfiguracioni fajl koji zahteva ASP.NET MVC za pokazivanje svega što se vidi folderu Views.
Retko treba da vršite izmene u Web.config fajlu.
3.1.2. Creating Styles for Your Theme
U folderu Styles napravite fajl pod imenom Site.css. (možete nazvati fajl kako god želite sve dok
ima .css ekstenziju). Sledeći primer prikazuje izgled stila (u ovom primeru je on jednostavan.)
/*
Theme: My First Theme
Author:
7 Mogućnost zadavanja komandi
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 70
Copyright:
*/
/* Colors Palette
Background: #d3d3d3
Text: #000
Main Accent: #999
Links: #c03
*/
/* Reset
***************************************************************/
html, body, div, span, applet, object, iframe,
h1, h2, h3, h4, h5, h6, p, blockquote, pre,
a, abbr, acronym, address, big, cite, code,
del, dfn, em, font, img, ins, kbd, q, s, samp,
small, strike, strong, sub, sup, tt, var,
dl, dt, dd, ol, ul, li,
fieldset, form, label, legend,
table, caption, tbody, tfoot, thead, tr, th, td {
margin: 0;
padding: 0;
border: 0;
outline: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
header, footer, aside, nav, article { display: block; }
/* Clearing Float
***************************************************************/
group:after {
content: ".";
display: block;
height: 0;
clear: both;
visibility: hidden;
}
.group {display: inline-block;} /* for IE/Mac */
/* General
***************************************************************/
body {
font: normal 100% Segoe UI,Trebuchet,Arial,Sans-Serif;
height: 100%;
text-align:left;
color:#000;
background: #d3d3d3;
}
/* Headings */
h1,h2,h3,h4,h5,h6,legend {font-weight:normal; font-style: normal;}
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 71
h1 {font-size: 160%;}
h2 {font-size: 145%;}
h3 {font-size: 130%;}
h4 {font-size: 120%;}
h5 {font-size: 105%;}
p { margin: 0 0 1em; line-height: 1.538em; }
p img.left { float: left; margin: 0.923em 0.923em 0.923em 0; padding: 0; }
p img.right { float: right; margin: 0.923em 0 0.923em 0.923em; }
a:focus,
a:hover { text-decoration: underline; }
a { color: #c03; text-decoration: none; }
#header {
background:#000;
color: #000;
width:100%;
height:50px;
margin-bottom:40px;
}
#branding h1{
font-size: 140%;
color:#fff;
padding:8px 0 0 40px;
}
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 72
/* Structure
***************************************************************/
#layout-navigation
{
width: 960px;
margin: 0 auto;
display: block;
border-bottom: 1px solid #dbdbdb;
}
nav ul
{
padding: 0px;
margin: 0px;
}
nav ul li
{
border:1px solid #dbdbdb;
background:#f6f6f6;
display:block;
float:left;
margin:0 2px -1px 0;
}
nav ul li.current
{
border-bottom: 1px solid #fff;
background:#fff;
}
nav ul a
{
padding:0 18px;
display:block;
float:left;
color: #333;
font-size: 1.077em;
text-decoration:none;
line-height:24px;
}
/* Main
***************************************************************/
#main {
margin:0 auto 40px;
width:600px;
}
/* Secondary
***************************************************************/
/* Forms
***************************************************************/
/* Misc
***************************************************************/
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 73
3.1.3. Adding a Layout to Your Theme
U folderu Views dodajte fajl za izgled (Layout.cshtml) i dodajte sledeći kod i markirajte:
@{
Script.Require("ShapesBase");
Style.Include("site.css");
}
<div id="header">
<div id="branding">
<h1>@T("Welcome to the Playground")</h1>
</div>
</div>
<div id="layout-navigation" class="group">
@Display(Model.Navigation)
</div>
<div id="main">
@Display(Model.Content)
</div>
3.1.4. Adding a Theme Image
Možete obezbediti malu sliku koja
predstavlja vašu novu temu koja će
se videti u Admin panelu. Slika se
mora zvati Theme.png i mora da se
postavi u folderu korena teme.
Sledeća slika prikazuje ovu novu
temu:
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 74
3.1.5. Applying a New Theme
Da bi se primenila tema, u Dashboard kliknite Themes. Pod Available izaberite novu temu i
onda kliknite Set Current.
Strana Manage Themes ponovo prikazuje, pokazujući, MyFirstTheme kao tekuću temu. Sada
možete otići na Vaš web sajt da vidite svoju temu na delu.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 75
3.2. Anatomy of a theme Tema omogućava korisnicima Orcharda da prilagode prevođenje sajta i da ga skroje prema
svojim potrebama i ciljevima dizajna. Teme mogu da izvedu ciljna preinačenja (override) stilla,
slika, izgleda ili bilo kog šablona koji pruža Orchard modul.
3.2.1. Where Themes Live
Tema je niz prikladno imenovanih fajlova unutar foldera. Taj folder mora da bude u folderu sa
temama u okviru baznog foldera Vašeg Orchard web sajta.
3.2.2. TheThemeMachine
Tema pod imenom TheThemeMachine je tema koja se
gradi u Orchardu. Možete ispitati ovu temu da bi ste
naučili o Orchardovim temama. Kao i bilo koja
druga, i ova tema može da se nađe u Themesfolder.
Tema TheThemeMachine dizajnirana je da bude
jasna, moderna tema, da bude dobra polazna tačka za
prilagođavanje i za razvoj novih tema. Ovaj članak
koristi ovu temu kao ilustraciju.
3.2.3. Anatomy of a Theme
Ovaj odeljak opisuje neophodne i opcione elemente
teme.
3.2.3.1. Manifest
Da bi bila valjana, tema mora imati manifest preko koga će je sistem prepoznati. Manifest je
tekstualni fajl pod nazivom Theme.txt koji se nalazi u korenskom folderu teme koju opisuje. Sledi
manifest za temu TheThemeMachine .
Name: The Theme Machine
Author: jowall, mibach, loudej, heskew
Description: Orchard Theme Machine is a flexible multi-zone theme that provides a solid foundation to build
your site. It features 20 collapsible widget zones and is flexible enough to cover a wide range of layouts.
Version: 0.1
Tags: Awesome
Website: http://orchardproject.net
Zones: Header, Navigation, Featured, BeforeMain, AsideFirst, Messages, BeforeContent, Content,
AfterContent, AsideSecond, AfterMain, TripelFirst, TripelSecond, TripelThird, FooterQuadFirst,
FooterQuadSecond, FooterQuadThird, FooterQuadFourth, Footer
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 76
Početak fajla daje temi korisno ime,
opis, autora, opis i dodatke. Polje Zones
daje listu naziva svih zona koje će biti
dostupne korisnicima kroz izgled i
šablone. Zone su kontejneri koji se
mogu dodati bilo kom šablonu ili
izgledu.
Različiti UI elementi mogu se ubaciti u
zone, ali su najčešće korisnički. Sve
zone ne moraju da budu prikazane u
manifestu, već samo one koje su
namenjene korisnicima.
Ova ilustracija pokazuje 19 zona, što je
tipično više nego što Vam treba za sajt.
Zone uključuju i naslov i zaglavlje
stranice, što su zone koje se nalaze na
vrgu i na dnu stranice. Postoji i
navigaciona zona u koju tipično treba
ubaciti i navigacioni meni.
Featured zone je mesto gde
možete staviti tekst sajta.
BeforeMain i AfterMain okružuju glavne zone na vrhu i na dnu.
AsideFirst i AsideSecond su mesta gde se postavljaju bočni tekstovi levo i desno od
glavnog sadržaja.
U centru strane nalazi se Messages zona gde stižu obaveštenja praćena BeforeContent,
zatim sadržaj, a onda zona Content i AfterContent.
Na dnu strane nalaze se TripelFirst, TripelSecond, i TripelThird koje možete koristiti ako
želite kolone na dnu i
FooterQuad zone koje možete koristiti ako želite četiri kolone.
Sve zone u TheThemeMachine su rasklopive što znači da će se prikazati samo ako u njima
postoji sadržaj.
3.2.3.2 Icon or Thumbnail
Theme.png fajl treba da bude sastavni deo svih Orchard tema. Ova slika treba da bude najmanje
400x400 piksela i namenjena je predstavljanju teme na galeriji ili na strani za administriranje
teme. Obično je mala slika stranice ili sajta koji se prikazuje korišćenjem teme.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 77
3.2.3.3. Widget Zones Preview Image
Opciono, slika provere korisničkih zona može se dodati temi. Slika treba da se postavi na koren
teme i da se zove ThemeZonePreview.png. Ova slika treba da bude 400 piksela i treba da prikaže
različite zone i njihova imena. Primer može da se nađe u TheThemeMachine.
3.2.3.4. Static Resources
Tipično za temu je da sadrži broj statičnih izvora, kao što su CSS stil, JavaScript fajlovi ili slike.
Ovi fajlovi moraju da budu u sledećim folderima:
CSS stil treba da bude u Styles folderu teme
JavaScript fajlovi treba da budu u Scripts folderu teme. Bilo koji tekst koji stavljate u ovaj
folder treba da bude prilagođen i da se odnosi samo na Vašu temu, a ne tekst koji je
namenjen ponovnoj upotrebi. Tekstovi za ponovnu upotrbu treba da se stave u poseban
modul.
Slike treba da budu u \Content\Images folderima. Ako Vaša tema sadrži nekoliko slika,
dobro je da ih držite na istom nivou. Međutim, ako imate mnogo slika preporučuje se da ih
organizujete u podfoldere.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 78
Pažnja Da bi fajlovi mogli koristiti svaki od foldera koji ima statičke fajlove kao što su stil,
slike ili JavaScript kod, treba da sadrže web.config fajl koji ima sledeći sadržaj:
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.web>
<httpHandlers>
<!-- iis6 - for any request in this location,
return via managed static file handler -->
<add path="*" verb="*" type="System.Web.StaticFileHandler" />
</httpHandlers>
</system.web>
<system.webServer>
<handlers accessPolicy="Script,Read">
<!-- iis7 - for any request to a file exists on disk,
return it via native http module.
accessPolicy 'Script' is to allow for a managed 404 page. -->
<add name="StaticFile" path="*" verb="*" modules="StaticFileModule"
preCondition="integratedMode" resourceType="File"
requireAccess="Read" />
</handlers>
</system.webServer>
</configuration>
3.2.3.5. Document
Document.cshtml se obično ne nalazi u temama zato što retko postoje razlozi da se nešto upisuje
preko njega. Većina tema može samo da se vrati na verziju fajla koja se može naći u
SafeMode temi pod \Views.
Document.cshtml file je odgovoran za HTML koji se nalazi oko body elementa. To znači da on
definiše doctype element (Orchard preuzima tip dokumenta
HTML5), html elemenat, head elemenat (gde on definiše zonu glave gde su meta nastavci),
neke script elemente, i vezu za tabake sa stilom koje treba ubaciti. (Ovo se razlikuje
od Header zone, koja je zona na vrhu glavnog dela.) Document.cshtml fiajl takođe sadrži
title element unutar head elementa. Konačno, fajl definiše body elemenat gde se daju zone Body
i Tail .
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 79
3.2.3.6. Layouts
Izgled stranice je krajnji oblik koji se daje unutar body elementa. Na primer, to je tipično mesto
gde se definišu korisničke zone. Tema može da sadrži bilo koji broj fajlova izgleda, čak i ako je
trenutno podržan samo jedan i uključen u TheThemeMachine temu, odnosno Layout.cshtml. Na
primer, tema može da doda specijalozovane izglede, kao što su Layout-Blog.cshtml ili Layout-
HomePage.cshtml, koji bi se koristili umesto osnove za blog ili za naslovnu stranu, pod uslovom
da postoji proširenje ili ekstenzija koja omogućava promene oblika izgleda. Zapazite da se
izgledi nazivaju Layout-{layout name}.cshtml. Svaki izgled može imati različit set zona,
različito markiranih.
3.2.3.7. Shape Templates
U Orchardu, pre nego što se web. stranica prevede u HTML, napravi se tree of shapes8. Oblici
su savitljivi predmeti koji će doprinositi izradi strane. Primeri uključuju zone, menije, elemente
menija i korisnike.
Svaki oblik se može dati kao šablon koji se može preinačiti temom. Šabloni imaju isto ime kao
oblik za koji su napravljeni. Na primer ako postoji Menu.cshtml, koristi se da pruži Menu oblik .
Tema TheThemeMachine ima dva šablona oblika BadgeOfHonor i Branding, koji su sagrađeni iz
Layout.cshtml i ubačeni u zone Header i Footer korišćenjem sledećeg koda
// Site name and link to the home page
WorkContext.Layout.Header.Add(New.Branding(), "5");
// Powered by Orchard
WorkContext.Layout.Footer.Add(New.BadgeOfHonor(), "5");
Pažnja Šabloni su jedan od dva načina da se da oblik. Uz šablone možete definisati oblikovanje
korišćenjem koda, definisanjem metoda koji ima atribut Shape. Potražite CoreShapes.cs fajl za
primere. Ovo se obično čini u modulima ali teme takođe to mogu da izvrše.
3.2.3.8. Item Templates
Teme mogu promeniti stavke sadržaja, uključujući šablone u \Views\Itemsfolder. Ime šablona
treba da bude Content-{content type name}.cshtml ili Content-{content type name}.{display
type}.cshtml. Na primer, šablon koji preinačuje stvaranje mesta za blog treba da bude
\Views\Items\Content-BlogPost.cshtml, a šablon koji preinačuje sadržaj bloga treba da bude
\Views\Items\Content-BlogPost.Summary.cshtml.
3.2.3.9. Part Templates
Teme mogu da primene prenošenje delova sadržaja. Ova konvencija je slična onoj za šablon
stavki sadržaja. Šablon za deo mora da bude u \Views\Parts i mora imati ime oblika za taj deo.
Na primer, davanje komentara može se primeniti stvaranjem fajla
\Views\Parts\Comments.cshtml.
3.2.3.10. Field Templates
Polja se takođe mogu menjati, mada još uvek ne na nivou pojedinačnog polja. Drugim rečima,
možete menjati izgled polja teksta, ali ne i izgled polja specifičng teksta. Da bi se promenio
8 Lista oblika
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 80
šablon polja, napravite fajl {field type name}.cshtml ili {field type name}.{display
type}.cshtml file u \Views\Fields. Na primer, izgled polja teksta može se menjati šablonom
\Views\Fields\Common.Text.cshtml.
3.2.3.11. Alternates
Varijante su niz sličnih oblika sa odogovarajućim šablonima, ili fajlovim izgleda koji Vam
omogućavaju da kontrolišete kako se različlite vrste sadržaja iznose unutar teme. Na primer,
možete koristiti varijante da primenite jedan fajl izgleda za osnovnu stranicu, a drugi fajl izgleda
za podstranice, ili možete koristit varijante da date elemente na jedan način, kada su elementi na
stranici, a na drugi način kada su na mestu za blog.
3.2.3.12. Widget Overrides
Izgled za korisnike može se takođe menjati stvaranjem šablona u \Views koji se zove widget-
{widget type}. Na primer, možete menjati izgled HTML korisnika i dodati crveni ram oko
sadržaja stavljajući fajl widget-htmlwidget.cshtml u \Views folder vaše teme:
div style="border:1px red solid">
@Display(Model.Content)
<div>
Primetite da je ovo samo jednostavan primer, a normalno dodavanje okvira bilo bi bolje
korišćenjem CSS.
3.2.3.13. Placement Files
Tema može da modifukuje tamo gde se daju oblici, uključujući placement.info , u korenu foldera
teme. Placement.info fajl je XML fajl. Evo primera:
Placement>
<!-- widgets -->
<Place Parts_Blogs_BlogArchives="Content:before"/>
<Place Parts_Blogs_RecentBlogPosts="Content:after"/>
<!-- default positioning -->
<Match ContentType="Blog">
<Match DisplayType="Summary">
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 81
<Place Parts_Blogs_Blog_Description="Content:before"
Parts_Blogs_Blog_BlogPostCount="Meta:3"/>
</Match>
</Match>
</Placement>
3.2.3.14. Markup
Markiranje u svakom fajlu je ograničeno izgledom sredstva koje ste izabrali. Za Orchard se
podrazumeva Razor (.cshtml fajlovi), za koje se uputstvo može naći na Template File Syntax
Guide.
U šablonima, objekat Model predstavlja trenutni oblik koji se daje. To znači da ako radite sa
oblikom poruke, koja ima svojstvo Message možete je prikazati pišući @Model.Message unutar
markiranog šablona.
Značajan dodatak koji Orchard pruža je Display koja prikazuje oblik. Na primer, ako pogledate u
fajl layout.cshtml , možete videti kako se daju zone korišćenjem poziva kao što je
@Display(Model.Content). Konačno, u različitim šablonima možete videti pozive, kao što su
@Html.RegisterScript("mystyle.css") ili @Html.RegisterScript("myscript.js"). Ovi registracioni
pozivi su neophodni jer se zbirke tekstova i stilova nalaze na zajedničkom mestu. Isti elemenat
linka ili scripta ne treba da se daje dva puta, čak i ako višestruki moduli, ili višestruku zahtevi
istog korisnika traže isti fajl.
3.3. Understanding placement info U CMS kao što je Orchard sadržaj se gradi kao sastav proizvoljnih delova. Na primer, mesto
bloga je skup smera i naslova (Routable part), glavnog dela (Body part), tagova (Tags part),
komentara (Comment part), i nekoliko tehničkih delova (Common and PublishLater). Da bi se
dobio šablon koji bi pružio ovakav objekat, moglo bi ste pristupiti svakom od ovih delova jasno i
eksplicitno i dati ih; na takav način radi Orchard. Ali tako se ne bi moglo rukovati nepredvidim
promenama u definiciji tipova sadržaja koji čine suštinu CMS. Na primer, šta ako je
administrator sajta preuzeo modul zvezdastog klasiranja i dodao deo klasiranja u postove. Ako je
izgled cele stavke eksplicitno definisan, morali bi ste eksplicitno da modifikujete i šablon.
U Orchardu to nije neophodno i dodavanje novog dela i njegovo prikazivanje može se izvršiti
bez diranja šablona. Ovo je moguće zato što dizajn Orcharda deli izgled u oblikovanje (koje se
izvodi šablonima ili metodima oblika) i postavljanje (koje se vrši kroz fajl the placement.info ).
Na ovaj način, delovi ne samo da mogu da odrede njihov podrazumevani izgled koji se menja
temom, već mogu takođe da odrede gde bi više voleli da se oblikuju, u odnosu na druge delove
(koji se takođe mogu menjati temama).
Određivanje postavljanja korišćenjem fajla placement.info , je predmet ovog članka.
3.3.1. The placement.info File
Ako pogledate fajlove Vašeg Orchard web sajta, videćete da većina modula i tema ima
placement.info u korenu. Ovo je XML fajl koji određuje postavljanje svakog dela stavke
sadržaja.
Sledi primer fajla postavljanja. (Posebno, to je placement.info fajl koji dolazi sa Orchard.Tags.)
Placement>
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 82
<Place Parts_Tags_Edit="Content:7"/>
<Match DisplayType="Detail">
<Place Parts_Tags_ShowTags="Header:after.7"/>
</Match>
<Match DisplayType="Summary">
<Place Parts_Tags_ShowTags="Header:after.7"/>
</Match>
</Placement>
3.3.2. Scope
Fajl postavljanja radi na nivou stavke sadržaja. To znači da ga možete koristiti da bi ste preuredili
prikaz delova bilo čega što je stavka sadržaja (postovi bloga, strane, komentari, obične stavke,
korisnici i sl.), ali ne obavezno proizvoljne oblike. Ako oblik koji ne predstavlja deo sadržaja
treba da rukovodi postavljanjem, na Vama je da obezbedite mehanizam za taj oblik.
3.3.3. The "Placement" Element
Placement elemenat mora da bude prisutan u korenu placement.info dokumenta. To je
jednostavan kontejner.
3.3.4. ”Place" Element
Place elemenat je glavna celina u a placement.info fajlu. On može imati bilo koliko atributa,
mada se preporučuje radi čitljivosti da ima samo jedno mesto oblika po Place elementu. Za
dodtne oblike možete dodati Place tagove, jedan po redu.
Svaki atripbut Place elementa je ime oblika (kao što su Parts_Tags_ShowTags), kao što je
definisano iz relevantnog drajvera delova i ima mesto kao vrednost. Da bi se odredili oblici koji
su deo prikaza date stavke sadržaja, možete pročitati kod za drajvere tog dela. Ili bi jednostavniji
metod bio da se osposobi modul Designer Tools i da se koriste alati za ispravljanje oblika, kako
bi se ispitao model.
Ime atributa može biti ime bilo kojeg oblika (ali ne alternativno ime; umesto toga koristite Match
kako bi ste prilagodili postavljanje). Postoje takođe posebne ekstenzije za izvesna polja, tako da
se postavljanje može usmeriti na slučajeve posebnih polja, na primer sledeće postavljanje će
sprečiti prikazivanje polja teksta pod imenom „Okupacija“
<Place Fields_Common_Text-Occupation="-"/>
Upozorenje za one koji prave polja: Ovo svojstvo možete dati Vašim sopstvenim poljima
koristeći posebnu izmenu ContentShape-a u svom drajveru koji obezbeđuje digerencijator ( deo
posle crtice u imenu atributa). Sama vrednost se deli u naziv zone (ovo je lokalna zona, obično
Header, Meta, Content. ili Footer), kolone, a onda pozicije. Pozicija se definiše tačkaste notacije.
Može biti pojedinačni broj (1,5,10,42) ili može biti niz brojeva odvojenih tačkom (1.2, 1.52.3,
itd.). Red će biti određen počevši od prvog broja, a onda ako višestruke pozicije imaju isti prvi
broj, korišćenjem potonjih brojeva. Na ovaj način, 1 dolazi pre 2.4.5, a 2.4.5 dolazi pre 2.10.
Postoji posebna vrednost “-“ koja potiskuje oblik dajući ga, umesto šaljući ga u lokalnu zonu.
Možete takođe koristiti kvalifikatore before i after da biste postavili oblike pre ili posle izvesne
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 83
pozicije. Na primer, Header:after postavlja oblik na sledeću dostupnu poziciju, prateći sve što je
definisano korišćenjem numeričkih pozicija. Nova karakteristika u Orchard 1.1. je mogućnost da
se odredi varijanta oblika i položaj (omotač) iz Place elemenata i da se preimenuje oblik.
Na primer ako želite da omogućite autoru teme da odredi drugačiji šablon za tagovanje blog
postova, možete uraditi sledeće:
<Match ContentType="BlogPost">
<Place
Parts_Tags_ShowTags="Header:after;Alternate=Parts_Tags_ShowTags_BlogPost"/>
</Match>
Autor teme onda može da pripremi Parts/Tags.ShowTags.BlogPost.cshtml fajl koji šablonizuje
prikazivanje tagova za blog postove. Slično tome, možete napraviti i omotač kao deo
postavljanja (Header:after;Wrapper=Wrapper_GreenDiv) ili preimenovanje oblika
(Header:after;Shape=IPreferToCallThoseStickersForSomeReason).
3.3.5."Match" Element
Match elementi vam dopuštaju da obuhvatite poseban deo Place tagova. Match elementi mogu
da imaju sledeći obim atributa:
• DisplayType. Obuhvata sadržane Place tagove na specifičnom tipu prikazivanja (kao što
je Detail orSummary )
• ContentType.Obuhvata sadržane Place tagove na specifičnom tipu sadržaja (kao što je
BlogPost ili Page ), ili stereotipe (kao što je Widget; ova karakteristika je nova za
Orchard 1.1).
• Path Obuhvata sadržane Place tagove na specifičnoj putanji ili na putanji i njenim
potomcima. Na primer, Path="/About" omogućava promene koje samo deluju na About
stranicu (pretpostavljajući da imate jednu), a Path="/MyBlog/*" deluje na sve što je pod
putanjom MyBlog, kao što je Myblog orMyBlog/FirstPost . Path atribut je nov za
Orchard 1.1. Match elementi mogu da se usade.
3.3.6. Overriding Placement
Svaki modul može da definiše podrazumevano postavljanje za delove i polja koje on obezbeđuje
posedovanjem placement.info fajla na korenu direktorijuma. To podrazumevano postavljanje
može se izmeniti bilo kojom temom, obavljanjem potpuno iste stvari. Postavljanje trenutne teme
će savladati svaki modul.
3.4. Packaging and sharing themes Orchard obezbeđuje karakteristike pakovanja koje vam dopuštaju da podelite teme koje ste
stvorili. Karakteristika stvara pakovanje (.zip fajl, u .nupkg formatu) koje sadrži vašu temu. Ona
takođe dopušta da prepišete svoju novu temu u Orchard Gallery. Ovaj članak vam pokazuje kako
da pakujete temu i da je prepišete u Orchard Gallery i kako da korisnici učitaju i instaliraju Vašu
temu.
3.4.1.Viewing the Packaging Modules
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 84
Da biste pregledali module za pakovanje, otvorite Orchard dashboard i kliknite na Modules.
Pomerajte do Packaging.
Packaging modeli se po pravillu
osposobljavaju. Ako je bilo koji modul
onesposobljen, morate ga osposobiti
kako biste ga pakovali i prepisali vašu
temu.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 85
3.4.2. Packaging Your Theme
Da biste pakovali svoju temu, otvorite Orchard komandnu liniju i ukucajte sledeću komandu,
zamenjujući MyFirstTheme imenom svoje teme i C:\Temp sa izlaznom putanjom za generisani
fajl pakovanja.
package create MyFirstTheme C:\Temp
Karakteristika pakovanja stvara .nupkg fajl. (Za više informacija pogledajte NuGet.org).
Ime .nupkg fajla je ime vaše teme plus broj njene verzije, kao u sledećem primeru:
Orchard.Theme.<nameOfYourTheme>.<version>.nupkg
3.4.3. Uploading Your Theme to Gallery
Pošto ste stvorili svoj paket možete podeliti temu davanjem nekome paket fajl. Možete takođe da priložite temu u
Orchard Gallery.
3.4.4. Installing a Packaged Theme
Da biste instalirali pakovanu temu u Orchard-u, otvorite Orchard dashboard. Kliknite na Themes a onda na
Install a theme from my computer
Kliknite na Choose File. Prelistajte i izaberite
(.nupkg) fajl pakovanja a onda kliknite na Open, pa
onda na Install. Ako Orchard radi na udaljenom
serveru, prelistavaćete lokalni kompjuter; ne treba da
stavite (.nupkg) fajl na server pre instaliranja.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 86
Vaša nova tema javlja se na Available.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 87
3.5. UI guidelines for theme authors Ovaj članak prikazuje preporuke za kodiranje i formatiranje HTML markiranje i CSS koji će
vam pomoći da održavate svoje teme organizovanim.
3.5.1. General Guidelines
Ovaj odeljak sadrži smernice za jedan broj tema dizajniranja kao što je testiranje pregledanja,
imena fajlova, HTML elementi, JavaScript i slike.
3.5.1.1. Browser Testing
Treba da testirate sve šablone koristeći najnovije verzije sledećih brauzera. Za starije verzije kao
što je Internet Explorer 6, treba da obezbedite da vaš sajt i šablon ostane funkcionalan, ali ne
pokušavajte da rešite pitanja izvođenja koja ne utiču na sposobnost korisnika da koristi sadržaj.
• Microsoft Internet Explorer
• Google Chrome
• Mozilla Firefox
• Apple Safari
• Opera
3.5.1.2. File Names
Sledi lista pravila za imenovanje fajlova koju prati Orchard razvijni tim.
• Uključite da fajle koriste podskor (_) kao prefiks
• .cshtml, .vbhtml, HTML, i CSS fajlovie treba imenovati korišćenjem kamel obloge.
3.5.1.3. HTML doctype Directive
Koristite HTML5 doctype deklaraciju jer vam ona dopušta da koristite HTML5 markiranje i
takođe je kompatibilna sa postojećim markiranjem koje se slaže sa HTML 4.01 and XHTML.
<!DOCTYPE html>
3.5.1.4. HTML Elements
Orchard podrazumeva upotrebu HTML5. Mada se od vas ne zahteva da koristite HTML5, to je
jaka preporuka. Jedan razlog je da on šablonizira iz različitih modula i roditeljske teme se mogu
koristiti na jednoj strani gde postoji samo jedna doctype deklaracija.
Sledeća lista navodi neke obično korišćene elemente HTML5 koji omogućavaju bolju strukturu
na web stranicama nego ranije verzije HTML5.
• <section>
• <article>
• <aside>
• <hgroup>
• <header>
• <footer>
• <nav>
• <figure>
• <figcaption>
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 88
Primer:
<figure>
<video src="tgif.vid"></video>
<figcaption>Example</figcaption>
</figure>
3.5.1.5. JavaScript and jQuery
Vaša veb stranica treba da radi čak i ako je JavaScript onesposobljen u brauzeru. Tekst treba da
se koristi samo da bi se povećao doživljaj stranice koji se pominje kao progresivno povećanje. Za
više informacija vidi Progressive Enhancement with JavaScript.
Orchard ima ugrađen jQuery. Orchard tim je standardizovan na jQuery kao svoj JavaScript okvir.
3.5.1.6. Images
Koristite odgovarajući format slike za scenario kao što je navedeno na sledećoj listi:
• Fotografije i gradijenti treba da koriste jpeg format
• Grafički elementi treba da koriste png format
• Koristite alfa transparentnost preko 24-bit png formata
• Koristite sprajtove gde je moguće kako biste poboljšali vreme učitavanja i smanjili broj
zahteva prema serveru.
3.5.1.7. Accessibility
Vaš HTML i CSS šabloni treba da prođu test dostupnosti koji se obezbeđuje preko Wave the web
accessibility evaluation tool. Vaši šabloni treba da zadovolje zahteve WCAG2.0 nivo AA.
3.5.1.8. Markup Validation
Preporučujemo da se uvek borite za saglasnost standarda. Obezbedite da vaši šabloni prođu
proveru valjanosti korišćenjem W3C Markup Validation Service.
3.5.1.9. CSS Organization
Da biste dopustili da korisnici lako nađu i pročitaju stilove za modifikaciju, preporučujemo da
standardizujete strukturu i format kodiranja. Orchard tim koristi organizacionu strukturu koja se
predstavlja u ovom poglavlju.
Da bismo Vam pomogli da se povinujete CSS standardima, imajte na umu sledeće smernice:
• Nemojte koristiti uobičajene tvrdnje kao kondicionalne if tvrdnje u stilovima
• CSS markiranje treba da bude validano sa CSS 2.1 ili višim. Možete takođe koristiti
opciono progresivno povećano CSS 3 markiranje.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 89
3.5.1.10. CSS Format Rules
Sledeća lista sadrži smernice za formatiranje CSS markiranja.
• Koristite četiri spejsa umesto tabs za identifikaciju (To se podrazumeva u Vizuelnom
Studiju.)
• Koristite crticu (-) između reči u selektorima.
• Sklonite nekorišćene CSS selekcije (osim za resetovane stilove).
• Koristite mala slova za definicije boja
• Koristite stenografsku notaciju gde je moguće, kao za kodove boja; koristite propale
osobine kad god je moguće
• •Koristite ID umesto klasa gde je moguće. Korišćenje ID za elemente šablona olakšava
identifikaciju značajnih seloektora u CSS i HTML.
• Koristite jedan red za definiciju svojstva
• Koristite "tab-nested" selektore
3.5.1.12. CSS File Structure
Preporučena struktura CSS je delimično adaptirana iz predloga koji su pribavljeni od Dan
Cederholm of SimpleBits. Ova struktura se nalazi u Style.css fajlu. Fajl uključuje sledeće
odeljke:
1. Info – komercijalni odeljak za temu sa kojom je povezan stil, autor, vebsajt i svaka
autorska informaacija.
2. Color Palette – Komercijalni odeljak koji definiše ukupnu kolor šemu za temu. Pruža
pojedinačno mesto da se definišu boje i olakšava korisnicima da pronađu, zamene i
modifikuju definicije boja.
3. Reset Definicije koje se koriste da bi se niormalizovalo postavljanje duž brouzera
4. Clearing Floats Definicije koje se koriste da se razjasne roditeljske stavke koje sadrže
potomke koji plutaju.
5. Typography - (Opcioni) Sadrži CSS kod ili referencu za okvir resetovanje tipografije (kao
što su YUI fontovi) koji normalizuju veličinu fonta kroz brouzere
6. General – Definicije za globalne HTML elemente kao što su <body>, naslovi, linkovi i
svi drugi elementi gde želite da primenite drugačiji stil i promenite resetovanje. Ovo
može da uključi stilove za elemente kao što su <ul>, <p>, itd.
7. Structure – Definicije prikaza za glavne komponente struktura vaših šablona, kao što su
kontejneri, naslovi, zaglavlja na dnu itd. Ovaj odeljak može da se podeli komentarima u
sekcije, kao što su navigacija, naslov itd.
8. Main – Glavni stilovi se odnose na vašu temu. Može sadržati definicije za blog postove,
tagove itd.
Secondary – Sekundarni stilovi se odnose na vašu temu za stvari kao što su stilizovani tekst,
greške itd.
9. Forms – Svaki stajling koji se odnosi na formiranje stavki.
10. Misc – Razne definicije koje su neophodne da se prikaže izgled vašeg šablona.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 90
Sledeći primer prikazuje strukturu primenjenu na CSS fajl.
/*
Theme: My Sample Theme
Author:
Copyright:
*/
/* Colors Palette
Background: #fff
Text: #434343
Main Accent: #999
Links: #443444
*/
/* Reset
***************************************************************/
YOUR CSS RESET CODE GOES HERE
/* Clearing Float
***************************************************************/
group:after {
content: ".";
display: block;
height: 0;
clear: both;
visibility: hidden;
}
.group {display: inline-block;} /* for IE/Mac */
/* Typography (Optional)
***************************************************************/
@import url(http://yui.yahooapis.com/2.8.1/build/fonts/fonts-min.css);
/* General
***************************************************************/
body {}
a {}
a:link {}
a:hover{}
a:visited{}
h1,h2,h3,h4,h5,h6 {}
/* Structure
***************************************************************/
#container {}
#header {}
#logo {}
#footer {}
/* Main
***************************************************************/
/* Secondary
***************************************************************/
/* Forms
***************************************************************/
/* Misc
***************************************************************/
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 91
3.5.1.1. CSS Reset
Uvek treba uvek da koristite resetovanje da biste normalizovali stilizovanje između brouzera a
onda da primenite ručno markiranje.
Ga biste resetovali global style
1. Primenite reset
2. Primenite stil po defaultu na bilo koji globalni elemenat (definisan u opštem poglavlju).
Primer:
p { padding: 0 10px; line-height: 150%;}
3.5.1.13. Typography
Koristite relativne veličine fontova i postavite podrazumevanu veličinu baze kako biste
obezbedili konzistentne veličine fontova među brouzerima i da biste omogućili korisnicima
brouzera da povećaju veličinu fonta i povećaju čitljivosdt. Međutim, zapamtite da su relativne
veličine kumulativne. Na primer, ako postavite veličinu div tagova na 2em, onda se
<div> elemenat ugrađuje unutar drugog <div> elementa a sledeći unutar njega, tako da ćete
završiti sa efektivnim postavljanjem od 8em za najdublji <div> elemenat.
• (Metod 1). Koristite emove i postavite veličinu fonta baze na <body> elemenat.
Podrazumevana veličina za srednji tekst u svim modernim brouzerima je 16px. Prvo, smanjite tu
veličinu za ceo dokument postavljanjem veličine fonta na <body> elemenat do 62,5%. Onda
možete razmišljati u pikselima ali ipak postavite veličine u emovima: 1 em je 10px, 0,8 ema je
8px, 1,6ema je 16 px itd.
3.5.1.14. Clearing Floats
Postoje dve metode koje možete koristiti da očistite pokretne zareze (float) bez dodavanja
markiranja.
• (Metod 1). Koristite position if everything metod sa semantičkom modifikacijom kao što
je prodeloženo u SimpleBits. Ovaj metod uključuje primenu clear ispravno na svaki
roditeljski elemenat koji sadrži stavke koje želite da imaju pokretni zarez (float).
• SimpleBits modfikacija menja ime klase na group, koja dodaje semantičku vrednost jer
se često odnosi na stavke kao grupe.
• (Metod 2) Primenite overflow:auto ispravno na roditeljski kontejner.
Izvesne kombinacije margina i ispunjavanja mogu da preopterete unutrašnje trake sa
komandama. Ako ne možete da sklonite stvari i pomerite trake, probajte da koristite
overflow:hidden, koji ima suštinski isti efekat i bez traka. Jedina mana kod hidden je da su su
neke slike grupisane na dnu strane.
3.5.1.15. Forms
Markirajte elemente forme korišćenjem metoda "ordered-list" (uređene liste). Ovaj metod
opisuje elemente forme kao uzastopnu listu imputa koje korisnik treba da ispuni. On obezbeđuje
i semantičko značenje i redosled oblika, što pomaže pristupačnosti. Kada se oblici daju bez
stilova, već su označeni po redosledu i imaju broj koji im je prodružen. Uređena lista pruža
dodatne informacije korisnicima, koje donose broj stavki na listi kada se prvi put otvori.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 92
<fieldset>
<legend>Delivery Details</legend>
<ol>
<li>
<label for="name">Name<em>*</em></label>
<input id="name" />
</li>
<li>
<label for="address1">Address<em>*</em></label>
<input id="address1" />
</li>
<li>
<label for="town-city">Town/City</label>
<input id="town-city" />
</li>
<li>
<fieldset>
<legend>Is this address also your invoice address?<em>*</em></legend>
<label><input type="radio" name="invoice-address" /> Yes</label>
<label><input type="radio" name="invoice-address" /> No</label>
</fieldset>
</li>
</ol>
</fieldset>
3.5.1.16. Progressive Enhancements
Bazirajte svoj dizajn na modernim brouzerima koji implementiraju savremene uzorke, a da se ne
upropasti iskustvo starijih brouzera. Ako smatrate da je potreban dizajn, koristite poznate CSS
tehnike kao što su klizeća vrata da bi se postigao željeni efekat.
1. Radijus ivice
2. Višestruke slike u pozadini
3. Gradijent
4. Transparentnost (RGBA i kapacitet)
5. Senke
6. Tekstualne senke
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 93
3.6. Customizing Orchard using Designer Helper Tools Orchards omogućava dizajnerski alat nazvan Shape Tracing koji vam obezbeđuje šabloniziranje
vašeg sajta. Shape Tracing modul pruža alate koje možete koristiti da selektujete odeljke svog
websajta i nađete informaciju o datom kodu.
3.6.1 Getting Started with Shape Tracing
Da biste koristili Shape Tracing prvo
omogućite Shape Tracing
karakteristiku u prednjoj ploči. Shape
Tracing karakteristika javlja se sa
Designer Tools modulom, koji možda
morate da instalirate. Pošto osposobite ovu
karakteristiku, primetićete uzani okvir na
dnu veb strane kada upravljate svojim
sajtom, slično sledećoj ilustraciji:
Kada se sruši okvir vašeg Shape
Tracing , vaš sajt funkcioniše
uobičajeno. Međutim, kada kliknete
na ikonu, okvir se širi i pokazuje
Shape Tracing karakteristike.
3.6.2. Shape Information
Kada se Shape Tracing okvir širi,
možete držati pokazivač miša preko odeljka
na strani i taj deo je istaknut (obeležen).
Kliknite na obeleženi deo da bi se pokazala
informacija o obliku i kako se on renderuje.
Leva strana okvira pokazuje koji je okvir selektovan. Ona
vam takođe omogućava koji oblik treba istaći (označiti)
obezbeđujući navigaciono stablo za oblike.
Desna strana pokazuje informaciju o selektovanom obliku i
omogućava vam da selektujete vrstu informacije za
prikazivanje.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 94
Shape Tracing pano uvek pokazjuje sledeće informacije:
• Shape .Informacija o obliku i šablonu da bi se dao oblik. Uključuje opciju stvaranja
varijanti kao što je opisano kasnije u članku.
• Model .Informacija o modelu za taj oblik
• Placement. placement.info fajl
• Template. Kod u fajlu šablona
• HTML. HTML za pružanje ovog oblika
3.6.3. Creating Alternate Templates
Shape Tracing interfejs prikazuje linkove koji vam dopuštaju da automatski kreirate varirane šablone za oblik.
Interfejs prikazuje dostupne varijante šablona i uključuje link pod imenom Create da bi se generisao taj šablon.
Opcija Create samo kreira šablon u određenom direktorijumu. Morate prilagoditi šablon da biste dobili oblik kao
što je potrebno. Ako koristite Visual Studio, morate uključiti šablon u svoj projekat biranjem Add > Existing
Item u Solution Explorer.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 95
4. Proširenje Orcharda
4.1 Uvod Cilj ovog teksta jeste da vas uvede u Orchard. Postoji mnogo koncepta koje bi trebalo da shvatite
kako biste dobili kvalitetan pogled na celu stvar pre nego što se ukopate u nju. Počećemo sa
osnovama koje bi trebalo da zna svaki korisnik interneta i postepeno ćemo ići sve dublje i dublje.
Nakon što pročitate ovaj deo, trebalo bi da imate dovoljno znanja da
počnete da se igrate sa Orchardom (kao dizajner/razvijač) bez prepreka zbog njegove
komplikovane arhihekture i terminologije. Prilikom prikazivanja, svaki novi termin je boldiran,
kako bi znali kada počinju novi termini.
4.1.1. Pregled rola u Orchardu
Najbolji način da se upoznate sa osnovama Orcharda jeste da pogledate role koje korisnik može
da ima: Običan korisnik (posetilac), administrator, dizajner i razvijač.
4.1.1.1. Korisnik
Kao korisnik, Orchard sajt je isti kao bilo koji drugi sajt: Počinje sa naslovnom stranom, sa koje
možete da pristupate ostalim stranama klikćujući na linkove. Zavisno od toga o kom sajtu se
radi, sadržaj može da varira (mogu biti statičke strane, blog, wiki, e-prodavnica, itd).
4.1.1.2. Administrator
Administrator ima pristup i drugim aspektima sajta:
1. Prilikom instalacije Orcharda, videće instalacionu stranu. Ovaj korak kreira bazu
podataka gde se čuva sav sadržaj i podešavanja sajta.
2. Takođe može da vidi naslovnu stranu
3. Može da pristupi dashboardu (kontrolna tabla) iz dva razloga:
a. Izmena podešavanja ponašanja i izgleda sajta (instalacija/degradacija)
b. Izmena sadržaja sajta.
4. Pristup komandnoj liniji, gde je moguće skriptovanje skoro svih administratorskih akcija,
a to olakšava automatizovanje nekih operacija.
4.1.1.3. Dizajner
Dizajner može da oblikuje izgled sajta. On može da izmeni postojeću temu (ako je dostupna) ili
da kreira novu. Tema predstavlja svu vizuelnu reprezentaciju sajta. Nekada se naziva i maskom
ili šablonom. Tema pretvara sadržaj u HTML koji se prikazuje u browseru. Npr. Vi napravite
blog post, a tema definiše kako se i gde pojavljuju meniji, naslovi, telo, komentari i ostalo.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 96
Zavisno od toga kolika je modifikacija potrebna, dizajner može da oblikuje neke ili sve elemente
teme. To su elementi sledećih tipova:
Documents; Definišu raspored i njegove zone. Ovo je cela reprezentacija stranice sajta.
Npr: Odlučuje da li sajt treba da ima jednu, dve ili tri kolone. Dakle, zona je kontejner
koji je deo rasporeda i koji može da drži neki sadržaj. Neke fleksibilne teme mogu i da
sakriju svoje zone.
Views; Vizuelna reprezentacija specifičnog sadržaja. To je uglavnom fajt sa ekstenzijom
.cshtml ili .aspx. On pruža HTML kod za prikazivanje specifičnog tipa sadržaja. Dakle,
stranica sa mnogo sadržaja (meni, blog post, komentar, itd) se kreira uz pomoć
kompozicije relevantnih View-a (pogleda).
Stylesheets, Javascripts i media fajlovi; Oni uglavnom služe da modifikuju izgled
definisan u pogledu. To su fajlovi kao što je “site.css”, jQuery ili slike za pozadinu, ivice
i ikonice.
Widget; Internet stranica uglavnom ima jedan glavni sadržaj (blog post), ali često ima
male delove sa informacijama sa strane. Npr: oblazi sa oznakama, lista poslednjih
postova, twitter feed, itd.
Layers; Layer (sloj) definiše na kojoj će stranici da se prikažu specifični widget-i. Npr,
želimo da se galerija prikazuje samo na stranici “slike/”.
4.1.1.4. Razvijač
Razvijač ima kompletan uvid u arhihekturu Orcharda i može je nadograditi. Orčard je
organizovan u modulima. Svaki modul pruža blok za dogradnju (plugin) sajta sa jasnim
ciljevima. Naprimer, može da ima:
Exstension modul: Dodaje neke karakteristike koji će poboljštati sajt, npr: sposobnost za
pretragu sadržaja ili korišćenje exsternog editora za pisanje bloga
Content modul: Dodaje sve što je potrebno za pregled/izmenu nekog tipa sadržaja.
Widget modul: Dodaje mali vizueni sadržaj koji može da se prikaže sa strane.
Theme modul: Menja izgled postojećeg sadržaja
Sve iznad: Modul može da ima više ekstenzija, tipova, gedževa i tema u jednom paketu
Orchard je dizajniran da bude proširiv; ovo znači da skoro sve sa čime radite može da se proširi,
zameni ili onemogući. Orchard dolazi sa nekoliko modula koji omogućavaju prijatno korisničko
iskustvo, ali dizajner ili razvijač mogu da ga promene ili naprave više. Takođe je moguće
deljenje vaših modula sa orchard zajednicom ili instaliranje modula koje su razvili drugi.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 97
4.1.1.5 Sadržaj
Kako bi popunili sajt, orchard pruža mogućnost izmene i prikaza sadržaja. On može da napravi
stranice i blogove odmah po instalaciji, ali takođe dopušta da vi definišete vaš tip sadržaj. Ovo je
važno jer možda želite da imate događaje, ili profile ili bilo šta drugo što nije iskonski podržano.
Sada ćemo objasniti par elemenata koji utiču na ove mogućnosti.
Content: Podaci su tipično prikazani na prednjem delu sajta i oni označavaju content
(sadržaj sajta)
Content type and item: content type9 je nalik dinamičkoj klasi; on definiše strukturu
podatka za određen tip sadržaja. Ta struktura može da se izmeni. Content item10
je
instanca klase, tako da BlogPost 11
može da bude content type, a kada napravite jedan, to
predstavlja content item.
Content part: Mnogi content type imaju više aspekata, a ti aspekti mogu da se kreiraju
nezavisno, i mogu biti ponovo uporebljeni. To predstavlja content part12
. Na primer:
blogpost može da ima komentare, fotografija može da ima komentare takođe; umesto da
implementiramo “comments” više puta, možemo ga napraviti kao content part i upotrebiti
za oba slučaja.
Content field: Zbog istog razloga, možemo da imamo manje tipove koji se ponašaju na
određen način. Npr: većina content type treba Datum, broj telefona, emal adresu, itd. Oni
nisu jednostavne osobine, jer možemo da im zakačimo validaciju, ali nisu ni content
parts, jer su jednostavnije.
Record: Ako želimo da sačuvamo content type u sql bazi, on se treba linkovati za record.
To je klasa sa svim osobinama potrebnim za snimanje. Npr: Map part treba da sačuva
njegove koordinate, tako da će biti povezan sa recordom sa geograf. Dužinom i širinom, a
orchard će da se pobrine za snimanje/učitavanje. Ne morate da brinete za recorde, osim
ako razvijate vaše module.
Jedan content type može da ima samo po jednu vrstu content part, ali može imati više content
field13
iste vrste. Na primer: blog post može da ima smao jedan primer komentara, ali može da
ima više datuma (datum kreiranja, poslednje izmene itd)
9 Tip sadržaja
10 Artikal sadržaja
11 Blog
12 Deo sadržaja
13 Polje sadržaja
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 98
4.2. Kako orchard radi Kreiranje CMS-a nije nalog kreiranju regularne web aplikacije; više je nalik slaganju kockica.
Prilikom dizajniranja takvog sistema, obavezno je da se pažnja obrati na proširivosti sistema.
Ovo može da bude da bude izazov jer otvorena struktura je potrebna za proširivost, a to ima
kompromisa na koristivost aplikacije. Sve što se pravi u sistemu mora da bude kompozitno sa
nepoznatim budućim modulima, uključujući i korisnički interfejs. Orchard ima misiju da
organizuje sve te male delove u jednu povezanu celinu.
Ova tema će da objasni izbore arhitekture koji orchard koristi, i kako rešava problema u vezi
fleksibilnosti i dobrog korisničkog iskustva.
4.2.1. Arhitektura
Modules
Core
Orchard Framework
ASP.NET MVC NHibernate Autofac Castle
.NET ASP.NET
IIS or Windows Azure
4.2.2. Temelji Orcharda
Orchard je izgrađen na postojećim frameworku14
i bibliotekama. Navešću par najosnovnijih:
ASP.NET MVC: Moderan pater za web programiranje koji podstiče separaciju briga.
Nhibernate: Objektno relaciona alatka za mapiranje. Upravlja postajanjem orchard
sadržaja u bazi podataka i uveliko pojednostavnuje model podataka tako što odbacuje
brigu o postojanju prilikom razvijanja modula. Možete da vidite primer u souce kodu u
bilo kom glavnom content tipu, npr. “pages”
Autofac: IoC15
kontejner. Orchard često koristi zavisne ekstenzije. Kreiranje jedne takve
je jednostavno kao pisanje klase koja implementira Idependency ili još specifičniji
interfejs koji je izveden iz IDependency , a korišćenje iste zahteva stavljanje
konstruktorskog parametra u pravom tipu. Scope zavisne ekstenzije biće određen Orchard
frameworkom. Primer možete da nađete u source kodu IAuthorizationService,
RolesBaseAuthorizationService i XmlRpcHandler.
Castle Dynamic Proxy: Koristi se za dinamičku generaciju proksija.
Orhcard aplikacija i framework su sagrađeni na ovim frameworkovima kao dodani sloj
apstrakcije. Postoji mnogo implementacije, a nije potrebno znanje iz navedenih oblasti da bi ste
radili sa Orchardom.
14
Okruženje za programere 15
Inversion of Control, abstraktni princip programiranja, inverzan u odnosu na proceduralno programiranje
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 99
4.3. Code generator Code generation je modul u Orchardu koji automatizuje zadatak kreiranja dodatnih fajlova i
ekstenzija. Ova karakteristika je korisna za razvijače koji žele da naprave controllers16
, data
migration klase, module, i teme. Međutim, ova opcija nije instalirana odmah. Možete je
instalirati uz pomoć Orchard galerije.
Otvorite administratorski panel,
kliknite na modules ispod gallery
zaglavlja.
Pronađite code generation modul,
i kliknite na install.
Da biste ga uključili, kliknite na
features pod configuration, nađite
code generation opciju i kliknite
na enable.
Ukoliko želimo da uključimo uz pomoć cmd linije, iskoristićemo sledeću naredbu.
orchard> feature enable Orchard.CodeGeneration
Enabling features Orchard.CodeGeneration
Orchard.CodeGeneration was enabled
16
Deo MVC paterna, zadužen za prikupljanje podataka.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 100
Kada je code generation modul uključen, nove komande za kreiranje modula, kontrolera, i tema
postaju dostupne. Code generation komande dodaju fajlove na odgovarajuću lokaciju.
codegen controller <module-name> <controller-name>
Create a new Orchard controller in a module
<feature-name>
Create a new Data Migration class
codegen module <module-name> [/IncludeInSolution:true|false]
Create a new Orchard module
codegen theme <theme-name> [/CreateProject:true|false][/IncludeInSolution:true|false][/BasedOn:<theme-
name>]
Create a new Orchard theme
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 101
4.4. Kreiranje “Hello world” modula U ovom delu ću napraviti vrlo mali modul za Orchard koji će samo da prikaže „pozdrav“
stranicu.
4.4.1. Uvod Orchard je napravljen na ASP.NET MVC, što znači da ukoliko ste već upoznati sa tim
okruženjem, osećaćete se kao kod kuće. Ako niste, objasniću u daljem tekstu.
MVC je patern gde su brige razdvojene: Imamo model (M) za podatke, kontroller (C) koji
diriguje korisničkim interfejsom i određuje kako će da se ponaša model, i pogled (V) koji samo
treba da brine o prikazivanju podataka koji mu prosledi kontroler.
U ovom slučaju (hello world) nemamo podatke, tako da se nećemo zadržavati sa modelom.
Imaćemo kontroler i pogled. Sve ostalo će biti neke osnovne stvari kako bi Orchard znao šta
radimo.
Moduli u Orchardu su paketi ekstenzija koje se mogu spakovati kako bi bilo ponovo korišćeni na
drugim Orchard sajtovima. Moduli se implementiraju kao MVC reoni. Reoni u MVC su
podsajtovi koji sadrže set karakteristika koje reaguju u izolaciji od ostalih delova sajta. Orchard
modul je jednostavno reon sa manifest fajlom. Može da koristi Orchard API-je, ali i ne mora.
4.4.2. Kreiranje strukture modula Pre nego što generišemo strukturu našeg modula, treba da skinemo, instaliramo i omogućimo
„code generation“ opciju u Orchardu. Nakon što je omogućimo, otvorićemo Orchard cmd liniju,
i kreirati HelloWorld modu sa sledećom komandom
codegen module HelloWorld
4.4.3. Modifikovanje manifest fajla Trebalo bi da imamo novi HelloWorld folder unutar foldera sa modulima u Orchard sajtu. U
ovom folderu ćemo naći module.txt fajl. Otvorite ga i prepravite sa sledećim primerom:
name: HelloWorld
antiforgery: enabled
author: The Orchard Team
website: http://orchardproject.net
version: 0.5.0
orchardversion: 0.5.0
description: The Hello World module is greeting the world and not doing
much more.
features:
HelloWorld:
Description: A very simple module.
Category: Sample
Ovaj tekst opisuje modul. Ovo će se prikazati u administrativnom prikazu modula.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 102
4.4.4. Dodavanje rute Vaš modul će trebati da reaguje na /HelloWorld relativni URL sajta. Kako biste deklarisali šta će
da se desi kada se URL poseti, kreirajte Routes.cs fajl u HelloWorld folderu:
using System.Collections.Generic;
using System.Web.Mvc;
using System.Web.Routing;
using Orchard.Mvc.Routes;
namespace HelloWorld {
public class Routes : IRouteProvider {
public void GetRoutes(ICollection<RouteDescriptor> routes) {
foreach (var routeDescriptor in GetRoutes())
routes.Add(routeDescriptor);
}
public IEnumerable<RouteDescriptor> GetRoutes() {
return new[] {
new RouteDescriptor {
Priority = 5,
Route = new Route(
"HelloWorld",
new RouteValueDictionary {
{"area", "HelloWorld"},
{"controller", "Home"},
{"action", "Index"}
},
new RouteValueDictionary(),
new RouteValueDictionary {
{"area", "HelloWorld"}
},
new MvcRouteHandler())
}
};
}
}
}
Ruta je opis mapiranja između URL-ova i akcije kontrolera. Ovaj kod mapira HelloWorld URL u
reon HelloWorld modula sa Home kontrolerom i Index akcijom.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 103
4.4.5. Kreiranje kontrolera Novi modul ima i Controllers folder koji treba da se popuni. Kreirajte HomeController.cs unutar
tog foldera sa sledećim kodom:
using System.Web.Mvc;
using Orchard.Themes;
namespace HelloWorld.Controllers {
[Themed]
public class HomeController : Controller {
public ActionResult Index() {
return View("HelloWorld");
}
}
}
Ovaj kontroler upravlja zahtevima za HelloWorld URL. Podrazumevana akcija, index, zahteva
da se renderuje HelloWorld pogled.
4.4.6. Kreiranje Pogleda U Views folderu, kreirajte folder sa imenom Home. U Views/Home folderu, kreirajte
HelloWorld.cshtml fajl:
<h2>@T("Hello World!")</h2>
4.4.7. Dodavanje novih fajlova u projekat Skoro pa je gotovo. Još nam preostaje da deklarišemo sistemu set fajlova koji se nalaze u modulu
kako bi se kompajlirali. Otvorite HelloWorld.csproj fajl u text editoru, i dodajte sledeće lnijie
koda nakon </IdemGroup> oznake:
<ItemGroup>
<Compile Include="Routes.cs"/>
<Compile Include="Controllers\HomeController.cs"/>
</ItemGroup>
Takođe dodajte sledeći kod u sekciju koja ima drugu oznaku za Content:
<Content Include="Views\Home\HelloWorld.cshtml" />
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 104
4.4.8. Aktivacija modula Najzad, sada možete da aktivirate novi modul, u cmd liniji unesite:
feature enable HelloWorld
Takođe se može postići i iz komandne table u admin interfejsu.
4.4.9. Korišćenje modula Ako sada dodate /HelloWorld u URL sajta, dobićete Hello World poruku:
Source kod modula se nalazi u folderu ovog dokumenta.
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 105
4.5. Pakovanje i deljenje modula Nakon razvoja modula za ekstenziju Orcharda, verovatno ćete želeti da ga delite sa drugima.
Orchard ima modul za pakovanje funkcija koje mogu da se koriste za kreiranje datoteke koju
sadrži vaš modul. Da biste omogućili ovu funkciju, posetite „Features“ deo na administratorskoj
strani Orcharda i aktivirajte funkciju „Orchard.packing“.
Kada je Orchard.Packaging funkcija omogućena, komandna linija Orcharda podržava dodatne
komande, koje mogu da se koriste za kreiranje paketa (.nupkg file) sa bilo kog modula u Orchard
instalaciji, kao i da instalirate novi modul sa upakovanim .nupkg fajlom.
package create <extensionName> <path>
Create a package for the extension <extensionName>
(an extension being a module or a theme).
The package will be output at the <path> specified.
The default filename is
Orchard.[Module|Theme].<extensionName>.<extensionVersion>.nupkg.
For example, "package create SampleModule c:\temp" will create the
package
"c:\temp\Orchard.Module.SampleModule.1.0.0.nupkg".
package install <packageId> <location> /Version:<version>
Install a module or a theme from a package file.
package uninstall <packageId>
Uninstall a module or a theme.
The <packageId> should take the format
Orchard.[Module|Theme].<extensionName>.
For example, "package uninstall Orchard.Module.SampleModule" will
uninstall the Module under the "~/Modules/SampleModule" directory and
"package uninstall Orchard.Theme.SampleTheme" will uninstall the Theme
under the "~/Themes/SampleTheme" directory.
user create /UserName:<username> /Password:<password> /Email:<email>
Creates a new User
Elektronsko poslovanje – Visoka tehnič ka s kola strukovnih studija Kragujevač
Orčhard ČMS Strana 106
Kada pokrenete „package create“ komandu – možete da kreirate zip datoteku modula.
orchard> package create Lucene C:\Temp
Package "C:\Temp\Orchard.Module.Lucene.1.0.0.nupkg" successfully created
Orchard koristi format NuGet da kreira paket modula (to su u suštini .zip fajlovi sa dodatnim
metainformacijama o vašim datotekama).
Kada kreirate pakt modula, možete ga lako deliti sa drugima. Orchard pruža mogućnost
pretraživanja i instaliranja modula iz sekcije „Modules“, na administratorskoj stranici Orcharda.
Pored toga, Orchard pruža funkciju galerije, koja može da registruje jedan ili više izvoda
ekstenzije modula galerije (OData Format). Korisnici mogu lako instalirati module sa bilo kog
registrovanog izvora.
Za pretraživanje i instaliranje dostupnih modula možete posetiti meni “Gallery admin panel”.
Sajt http://orchardproject.net/gallery pruža front-end koji možete pretražiti da biste pronašli i
preuzeli dostupne module i teme.
Lako možete da dodate Vaš paket-modul na sajt Galerije modula, kako biste ga podelili sa
ostalim korisnicima Orcharda.