Openinghours Userguide
Openinghours Userguide
v1.1
Installation & User Guide
Last update : 15/03/2014
oo!la!ino."o! # Great $%tensions &or '() *oo!la+ , 'onta"t us at support-oo!la!ino."o!
Installation
Opening Hours is "o!pati.le /it0 )o.i1ro 1.0 and 1.1.
2irst un3ip 4our do/nloaded 3ip &ile. Inside 4ou /ill &ind Opening Hours 1.0
installation pa"5age :
so.ipro6opening0ours6l!610.3ip &or )o.i1ro 1.0.%7
so.ipro6opening0ours610.3ip &or )o.i1ro 1.1.%.
Installation is si!pl4 done via )o.i1ro appli"ation !anager8 availa.le in )o.i1ro
ad!inistration panel :
On 4our "o!puter or L9:8 sele"t 4our do/nloaded Opening Hours .3ip
;so.ipro6opening0ours6l!610.3ip &or )o.i1ro 1.0 or
so.ipro6opening0ours610.3ip &or )o.i1ro 1.1< in t0e =Install 9ppli"ation= &ield
and /ait &or "o!plete installation.
Opening Hours &ield appli"ation is no/ availa.le in )o.i1ro=s 9ppli"ations list :
oo!la!ino."o! # Great $%tensions &or '() *oo!la+ , 'onta"t us at support-oo!la!ino."o!
>0at=s it + Opening Hours appli"ation &ield &or )o.i1ro is installed.
Getting started
?ou "an no/ add an =Opening Hours= &ield into 4our )o.ipro entr4 &or! to allo/
ad!in and users to enter opening 0ours and annual "losing dates.
>0ere are ust a &e/ spe"i&i" para!eters to set up in Opening Hours &ield
ad!inistration panel:
@ate pi"5er &or!at
>0is &or!at sets date pi"5ers &or!at used in )o.i1ro ad!in panel and edit
&or!s.
1lease re&er to http://php.net/manual/en/function.date.php to &it t0is &or!at to 4our
needs.
2or e%a!ple8 =!/d/?= is used 0ere :
oo!la!ino."o! # Great $%tensions &or '() *oo!la+ , 'onta"t us at support-oo!la!ino."o!
:ote : t0is setting is also used in t0e e%tended sear"0 &or! to "on&igure
Opening Hours sear"0 &or!.
@ispla4ed dates &or!at
>0is &or!at is used &or displa4ing dates ;ne%t opening date or annual "losing
dates &or e%a!ple< in )o.i1ro=s vie/s.
1lease re&er to http://php.net/manual/en/function.date.php to &it t0is &or!at to 4our
needs.
@ispla4 a..reviated te%tual representation o& da4sA
2or e%a!ple8 do 4ou /ant to displa4 =(on,2ri= in 4our )o.i1ro details vie/ or
=(onda4,2rida4=A
12,0our "lo"5 ti!e pi"5erA
9llo/s ti!e pi"5ers to displa4 a 12,0our "lo"5 &or!at in )o.i1ro ad!in panel
and edit &or!s.
:ote : t0is setting is also used in t0e e%tended sear"0 &or! to para!etri3e
Opening Hours sear"0 &or!.
@ispla4ed ti!e &or!at
>0is &or!at is used &or displa4ing ti!e ;ne%t "losing ti!e &or e%a!ple< in
)o.i1ro=s vie/s.
1lease re&er to http://php.net/manual/en/function.date.php to &it t0is &or!at to 4our
needs.
I!portant: i& 4ou need to use a spe"ial separator string or "0ara"ter .et/een
0ours and !inutes8 use t0e &ollo/ing s4nta% :
B&or!at &or 0oursCDseparatorEB&or!at &or !inutesC
2or e%a!ple8 to displa4 =0F000=8 enter : HD0Ei
@o not use se"onds ;s< and !i"rose"onds ;u< in 4our ti!e &or!at.
oo!la!ino."o! # Great $%tensions &or '() *oo!la+ , 'onta"t us at support-oo!la!ino."o!
I!portant: in t0is version o& Opening Hours8 t0e ti!e 3one used is t0e server
ti!e 3one as "on&igured in *oo!la=s ad!in panel : Glo.al
"on&iguration/)erver/Lo"ation )ettings/)ervi"e >i!e Gone.
>0at !eans t0at i& a dire"tor4 visitor .elongs to anot0er ti!e 3one t0an t0e
server ti!e 3one8 t0e Open/'losed .oard state /ill .e "orre"t8 .ut all ti!es
displa4ed 0ave to .e "onsidered lo"al8 in t0e server ti!e 3one.
@e&ault ti!e ranges
>0is &ield allo/s 4ou to de&ine de&ault ti!e ranges so t0at ti!e pi"5ers /ould .e
pre&illed in )o.i1ro ad!in panel and edit &or!s.
2or!at to use : Bti!eC 7Bti!eC... /it0 a valid Bti!eC &or!at as de&ined in
http://php.net/manual/en/function.date.php.
9dd &ield=s ')) "lass as "lassA
I& t0e ')) "lass o& t0e Opening Hours &ield is not alread4 added in t0e H>(L
la4out o& t0e H'ard or @etails vie/ ;via t0e .%sl "ode<8 4ou "an add it &ro! 0ere.
2or e%a!ple8 =sp2ield= "lass is added to t0e Opening Hours &ield /rapper =o0,
.oard=:
9dd &ield=s alias as idA
I& t0e id o& t0e Opening Hours &ield is not not alread4 added in t0e H>(L la4out
o& t0e H'ard or @etails vie/ ;via t0e .%sl "ode<8 4ou "an add it &ro! 0ere.
In t0e previous s"reens0ot8 =&ield6opening60ours= is set as id &or t0e Opening
Hours &ield /rapper =o0,.oard=.
@ispla4 0ori3ontall4 in vie/sA
Opening 0ours are displa4ed verti"all4 .4 de&ault in )o.i1ro=s vie/s .ut "an .e
displa4ed 0ori3ontall4 too:
(onda4 >uesda4 Iednesda4 >0ursda4 2rida4 )aturda4 )unda4
F:00 # 1J:30 F:00 # 1J:30 F:00 # 1J:30 F:00 # 1J:30 F:00 # 1J:30 F:00 # 1J:30 'losed
'enter la.elsA
@o 4ou /ant opening 0ours to .e "entered in t0eir displa4 3one A
2,line displa4A
oo!la!ino."o! # Great $%tensions &or '() *oo!la+ , 'onta"t us at support-oo!la!ino."o!
>0is option allo/s 4ou to displa4 opening 0ours on one or t/o lines:
(onda4: F:00 # 1J:30
or
(onda4
F:00 # 1J:30
J,da4 displa4A
2alse .4 de&ault8 t0is !ode allo/s to displa4 opening 0ours &or t0e all t0e J
da4s o& t0e /ee58 even i& one or !ore o& t0e! are "onse"utive and identi"al.
Load Kootstrap >i!e pi"5erA
I& 4our dire"tor4 alread4 loads Kootstrap >i!e pi"5er8 disa.le its loading 0ere.
Load Kootstrap @ate pi"5erA
I& 4our dire"tor4 alread4 loads Kootstrap @ate pi"5er8 disa.le its loading 0ere.
>o let 4our ne/ installed Opening Hours &ield .e sear"0a.le8 ust ena.led t0is
&un"tionalit4 in t0e standard )ear"0 2ields settings:
oo!la!ino."o! # Great $%tensions &or '() *oo!la+ , 'onta"t us at support-oo!la!ino."o!
Open/'losed status .oard
Opening Hours version 1.1 uses no/ *Luer4/*avas"ript to displa4 its
Open/'losed status .oard.
>0e advantage is t0at it allo/s a real,ti!e displa4 and let 4ou ena.le all t0e
)o.i1ro opti!i3ation &eatures : t0e data a""elerator &or e%a!ple.
2irst step to displa4 t0e open/"losed status .oard8 4ou 0ave to i!ple!ent it in
4our )o.i1ro te!plate.
to add t0e .oard in t0e v"ard vie/8 !odi&4
"o!ponent/so.ipro/usr/te!plates/B4ourte!plateC"on&ig.ini
to add t0e .oard in t0e detail vie/8 !odi&4
"o!ponent/so.ipro/usr/te!plates/B4our te!plateC/entr4/details.ini
to add t0e .oard in t0e sear"0 vie/8 !odi&4
"o!ponent/so.ipro/usr/te!plates/B4our te!plateC/sear"0/sear"0.ini
.4 adding t0e 4ello/ !ar5ers "ss and s &ile to 4our General ini se"tion as
!entioned .elo/ :
DgeneralE
te!plate6t4pe M N%sltN
"ss6&iles M N.ootstrap..ootstrap8i"ons8edit8&or!,responsive8de&ault8o0.oardN
s6&iles M
NLuer48.ootstrap8.ootstrap.tooltips8.ootstrap.popover8/allti!e//allti!e,data8
/allti!e//allti!e8o0.oardN
I(1OO>9:> : i& 4ou use t0e )o.i1ro=s @ata 9""elerator and i& 4ou /ant to displa4
t0e open/state status .oard not onl4 in t0e detail vie/ .ut in t0e v"ard vie/
too8 4ou 0ave to add =o0.oardinit= .e&ore =o0.oard= in t0e s6&iles 5e4 value :
s6&ilesMNLuer48.ootstrap8.ootstrap.tooltips8.ootstrap.popover8/allti!e//allti
!e,data8 /allti!e//allti!e8o0.oardinit8o0.oardN
In t0e sa!e ti!e8 "usto!i3e t0e o0.oardinit.s ;lo"ated in
/"o!ponent/so.ipro/li./s< to adapt it to 4our /e.site langage;s<.
@o not 0esitate to "onta"t support-oo!la!ino."o! &or !ore in&or!ation and
support.
oo!la!ino."o! # Great $%tensions &or '() *oo!la+ , 'onta"t us at support-oo!la!ino."o!
'usto!i3ation
'))
In )o.i1ro ad!in panel and entr4 edit &or!s8 >/itter KootstrapP is used to
la4out t0e Opening Hours input &or!.
2ield=s "lass and alias are added to t0e la4out8 so 4ou "an "usto!i3e t0e displa4
via ')) on 4our )o.i1ro edit and add &or!s.
9s s0o/n on t0e &ollo/ing s"reens0ot8 t0e Opening Hours &ield displa4 in
H'ard and @etails vie/s "an .e easil4 "usto!i3ed /it0 ')) too:
2or e%a!ple8 use =o0,da4s= and =o0,annual"losing= "lasses to 0ide t0ese parts o&
Opening Hours and displa4 onl4 a "usto!i3ed Open/'lose .oard.
PI!portant : H>(L la4outs o& Opening Hours &or )o.i1ro 1.0 and 1.1 are
identi"al. Kut t0is lega"4 !ode version does not i!port >/itter Kootstrap ')):
it repla"es it /it0 a "usto! ')) e!.edding onl4 ver4 s!all su.set o& >/itter
Kootstrap8 e%a"tl4 adapted to Opening Hours needs.
2onta/eso!e is not i!ported in Opening Hours &or )o.i1ro 1.0 : a s!all set o&
"usto! i"ons ;.pg< is used.
oo!la!ino."o! # Great $%tensions &or '() *oo!la+ , 'onta"t us at support-oo!la!ino."o!
Language
O& "ourse8 Opening Hours &ield uses *oo!la=s language &iles to .uild its displa4s.
In BlanguageC.)p9pp.opening0ours.ini &ile8 4ou /ill &ind :
da4s and !ont0s te%tual representations ;&ull and a..reviated<7
all states: =open=8 ="losed=8 =all da4=8...
all separator /ords .et/een ti!es and dates ; &ro!8 to8 until8 Q.<7
all separator "0ara"ters .et/een da48 date and ti!e ranges.
9ll t0ese ite!s "an .e overridden via *oo!la=s language overrides &eature8
availa.le in t0e ad!in panel : $%tensions/Language (anager.
>0is version o& Opening Hours "ontains onl4 =en,GK= language &ile.
(i"rodata
Opening Hours i!ple!ents (i"rodata &ro! )"0e!a.org : &or ea"0 da4 ;or ea"0
group o& si!ilar da4s<8 ti!e ranges "an .e /rapped auto!ati"all4 in t0e
=openingHours= propert4 o& t0e =Lo"alKusiness= s"0e!a.
2or !ore in&or!ation on 0o/ to !ar5up 4our "ontent /it0 !i"rodata and
s"0e!a.org in 4our )o.i1ro vie/s8 please re&er to http://schema.org/LocalBusiness.
>0is /rapping "an .e ena.led or disa.led &ro! t0e Opening Hours
ad!inistration panel ;=Use !i"rodataA=<.
)upport
2or !ore in&or!ation8 spe"i&i" needs8 &eed.a"5 and suggestions8 please "onta"t
support-oo!la!ino."o!.
oo!la!ino."o! # Great $%tensions &or '() *oo!la+ , 'onta"t us at support-oo!la!ino."o!