A – Adownload.tutoriali.org/Tutorials/Web_Aplikacije/Orchard.pdf · 1.2.5. Podesavanja sajta ... Da bi napravili Orchard sajt, mnogi programeri će želeti da koriste bazu podataka

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



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



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



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



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.

http://docs.orchardproject.net/Documentation/Working-with-Orchard-in-WebMatrix

http://docs.orchardproject.net/Documentation/Working-with-Orchard-in-WebMatrix

http://docs.orchardproject.net/Documentation/Manually-installing-Orchard-zip-file

http://docs.orchardproject.net/Documentation/Manually-installing-Orchard-zip-file



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.



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.



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.



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.



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.



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.



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.



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.



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.





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.



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.



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.



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



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.



Kliknite na OUR BLOG tab na pocetnoj stranici.Ovog puta, vidite da je blog dodan meniju I da

prikazuje ono sto ste uneli.



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.



Napomena: Ako “smanjite” URL na samo /TAG/ deo mozete videti listu dostupnih tagova na

vasem sajtu.



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



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



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.



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.

http://orchardproject.net/

http://docs.orchardproject.net/Documentation/Creating-custom-content-types

http://docs.orchardproject.net/Documentation/Adding-a-Blog-to-Your-Site

http://docs.orchardproject.net/Documentation/Adding-pages-to-your-site

http://docs.orchardproject.net/Documentation/Adding-pages-to-your-site

http://docs.orchardproject.net/Documentation/content-types

http://docs.orchardproject.net/Documentation/Moderating-comments

http://docs.orchardproject.net/Documentation/Managing-widgets

http://docs.orchardproject.net/Documentation/Managing-widgets

http://docs.orchardproject.net/Documentation/Adding-and-Managing-Media-Content

http://docs.orchardproject.net/Documentation/Adding-and-Managing-Media-Content

http://docs.orchardproject.net/Documentation/Navigation-and-Menus

http://docs.orchardproject.net/Documentation/Organizing-content-with-tags

http://docs.orchardproject.net/Documentation/Installing-modules-and-themes-from-the-gallery

http://docs.orchardproject.net/Documentation/Enabling-and-Disabling-Features

http://docs.orchardproject.net/Documentation/Installing-and-Upgrading-Modules

http://docs.orchardproject.net/Documentation/Installing-and-Upgrading-Modules

http://docs.orchardproject.net/Documentation/Installing-Themes

http://docs.orchardproject.net/Documentation/Installing-Themes

http://docs.orchardproject.net/Documentation/Previewing-and-Applying-a-Theme

http://docs.orchardproject.net/Documentation/Managing-Users-and-Roles

http://docs.orchardproject.net/Documentation/Modifying-Site-Settings



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



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.



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.



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.



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.



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.



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.



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.



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



Da bi izmenili podatke pojedinacnih slika kliknite na njih.



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.



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.



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.



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.



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.



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.



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.



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.



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”.



Nakon sto ste dodali polja, vas sospstveni tip sadrzaja izgleda kao na slici. Kliknite na dugme

Save (sacuvaj ) kako biste sacuvali sopstveni tip sadrzaja.





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 ).



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.



1.11.4. Prikazivanje Liste

Da bi videli listu recenzija knjiga vratite se na pocetnu stranicu, a zatim kliknite na stavku New

Book Reviews.



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

http://gallery.orchardproject.net/



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.

http://orchardgallery.codeplex.com/



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.



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“.



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.



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.



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.”



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.



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



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



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



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.



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



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.



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



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



Da biste izmenili dozvole za datu ulogu, kliknite na Edit pored uloge imena.



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



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;}



h1 {font-size: 160%;}





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;

}



/* 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

***************************************************************/



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:



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.



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



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.



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.



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>



<add path="*" verb="*" type="System.Web.StaticFileHandler" />

</httpHandlers>

</system.web>

<system.webServer>

<handlers accessPolicy="Script,Read">



<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 .



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



š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>



<Place Parts_Blogs_BlogArchives="Content:before"/>

<Place Parts_Blogs_RecentBlogPosts="Content:after"/>



<Match ContentType="Blog">

<Match DisplayType="Summary">



<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>

http://docs.orchardproject.net/Documentation/Template-file-syntax-guide

http://docs.orchardproject.net/Documentation/Template-file-syntax-guide



<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



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



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.



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.



Vaša nova tema javlja se na Available.



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>



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.

http://www.alistapart.com/articles/progressiveenhancementwithjavascript/



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.



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

***************************************************************/



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.



<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



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.



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.



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.



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.



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



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



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.



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



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.



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.



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" />



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.



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



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.