From 0bb891b8ee4e5ed1556373b9c8b7bb830b8d27cc Mon Sep 17 00:00:00 2001 From: Ben Szymanski Date: Mon, 1 Dec 2025 02:38:58 -0600 Subject: [PATCH] Update Entity Actions article to support Umbraco v16, v17. Refreshed and verified code samples. Formatting improvements. Additional clarity around entity action permissions. --- .../granular-user-permissions-ui-custom.png | Bin 0 -> 127002 bytes .../extension-types/entity-actions.md | 348 +++++++++++------- .../granular-user-permissions-ui-custom.png | Bin 0 -> 127002 bytes .../extension-types/entity-actions.md | 348 +++++++++++------- 4 files changed, 444 insertions(+), 252 deletions(-) create mode 100644 16/umbraco-cms/.gitbook/assets/granular-user-permissions-ui-custom.png create mode 100644 17/umbraco-cms/.gitbook/assets/granular-user-permissions-ui-custom.png diff --git a/16/umbraco-cms/.gitbook/assets/granular-user-permissions-ui-custom.png b/16/umbraco-cms/.gitbook/assets/granular-user-permissions-ui-custom.png new file mode 100644 index 0000000000000000000000000000000000000000..cbf863e98a0cea4d0ee0023bcb0e94ad522522c3 GIT binary patch literal 127002 zcmeFZcT|(x`YjBCf`S6lF?0p#y#%QOBGN<%y$A>h2uSZBic}3KRjPCdO{90FOYaB> zXz0C$7RtBcIcM+lyWiP*{<&k^aqo5vBqVR%vdXjOGoLwE$bD6X%a>>_VPRoiR=g|s z01FG>5eo|^0RIAbr%fUt6$|T9v6ZaseMMPWhWn287FJKpv9RujM91Q3lIl{nO?PEb z>fMgM>Zu@xoe@A6y35Yac#-%Xq5pd(;YSYVN1un{YdOQ@KHnjiFMeo3^5iR}oLp3I z%k#_8_RnO$P8KC?B=5|h^dzBAH|j-p=D%S-L-de@446Q%_yfj}yv9U#l%GIwq;T7@ zupK`^Za%HlWzxEPmqFUL`Yg|<7Vmw?Y58HmNW;`w5liokr33b}+xJyx%^d{pOTI1- zH+Um@4Qux1@~B}VSNwPGs3lWDnWz-Cr`u$H$={n5Tko@&F*S;-TVP4Qe=3T6gmu#* zC*@6(${m-Rq&6SOwsCJq?c8_mZr5p+tvYYcEO;kiJ3vxkOHJ&HU%zscwWH{l2g!P! z86>s1x@pcm17}XRPAkkal(H6h<*wb3U!@f0qp!B?9i%vaS2s>n#6A9eZEhlqs63Jq z+Wn2Qx6-QT9+9P*K==$f!?0q?HPLRxbM#iP7!qjtx{ohSKrEykudnC+N%>Xw5Kl~i;%Fn~k!M%e3iD*pt9+>f z!%s2rZq<;@$aNe`7Qgxkq4am;%-yfs_P3KmLZVv3K1yUbg$&4MY#lor=Sp#~8i)yB z^MP8n2HxH0jh>`r{z3w6LGzUh{2n%8;1Q^IzD;2q`?r4+zU6Y)o1| zl$Vy{JVdUl*3oRpvi4rj7~-4J-?@dwT`)5 z((}K}XJnbZx{rxM=S_1M!dy?%^t-aJRl zpBC_#c^;p1OYZp_(d!pUm^mVtGRSh}tRpNkXscfDGBveR5?+yQ;^m#EvV29)ae3!qhcX`oUZ+bj>3sJZ2lFcpvB; zL=&&}5HCF2X=*_}aOixx;!yLnta7K)&OpkJEW9lbsj|g=@K78tx0kDgO}j{hzj%#45WFyKKWNh7q8tC7Lv)lG#VRxy$nA>zmf$U8`EQ-LiOhi9U9 z-m+4^HMmQXp*djvfI2tO`Q2{ZZn84VN(Akf)JNDJWoNbHj zqB+hS@tpV^_MAlYJ)!s28Z$X#Lzjoxm*tl=mMy8{U%e#M4`eNQkaauDXg;Rvnr>Qt zJ*SeZ|C7QexvOkr2_Ksr<)AoFH7NYsrK(F+ELC(>>K^g6(cT}t1CKoqnYTx0joH7G z6Oz@EyI(qg2~Ez;zB@=9&)pr_npu!a``$3?a-V~CNg)lP3hU%S$UvG^mG#Baa_chdI@6o{I)SNQf|A?`he9qTWcYNTQN2_A)^LXq2eZ|ro?lXN3BS2BUMs8B{wCl!LY&b zEYd$!ru4JkiwiGe1K9(gG#NBmH?`f-WEM$RPQRCat5wu2%OQS?dxo3zYje-_mW;;P zEVd`s_Uycq=Hs@3LQaCD@vwMQoJN=KJam3|-iP8Ig+Ik1#bpY6izdX+xL zHD)OWkCR@PP3KU5PG3mBu0*(aUQb(Rx;Slv-3y)MJiqy^tTp9u4=d*-y}bz2{H ziM@tAytkdV4c0xT2)4FS?Ayz`TAT1)?tS0o^qI(2jWq$J%|cDrel7h7&nNp5Vn=k(rGrrBn$cRY{A$@A8xHB!+_DnF|5?mT{bOk|Tb zDoFX5ET4Vx?8|=k^6huG9ZY)l7RtPQTaP&ps+^L#t7%t!$+kiZDfKC0Dg5+%4gF3i z^Nc%usiz}KQ=QUJS|<~pCIlp`+qzD8SIX62ugLII>WeulcvT>;FZD#fa!oJSb}4x+ zW9{u)ow>jH>s!07PsXW}Wd=omPuJb|K(A;DsOryM(@h!@s)VMM-C*TsjtL{~R6*@F-W=4Az8t)}6(%c<#G z3N>&KTAO^nqA~3}O?__&Bo^Z5!t|rLE)tt{LX}T#IB`U(t^}^7tw}V@Q$TNZ*J{!B zmF=qCw!O8Dt6kwOGl%*6VXjIox-BKwdf)VrCtkDfwxyNe5tH&}JiP5U(O9lPX~sQO zMdq2ipgW7K0Mn~C&>rNQ|MYW4}FG|JDPXl$JcaNcyV}G za=QeZ58||R+ihmr#%s;1ch3XmB2M79myoWmdgo^c&(iuT+y z8Un1#1)YjJS=K9xFS1VYSS}v3CLE>#)*94Ukj_|ex8TX%7qRN(68hT>e$Q#FsXIy_QD`S*xSjKNaKQadUIyb`#*XceLc;gF>M^ zy!<@;{9ND&E+-E=XA^fWJ16FUoaA5Uku!HPbF_NuY-Ml9fH|*;slAJ{1QQeHLVx`G z$97I;7&%qKj2+`K%0oEv;q9P_T&eJgkKC%ST0wxG?xH6)?Dyy8EP z|NnjR=N13$n>v4flb=tR|KGp*Zy)`yUxhiDJIdPIf@?ZU{@Gvu{PMql_|Gqj^I#tR z-E&o&>HlFY!MkVY`Yp>NZwrdIUHhj! z5nD5?AqWN%+f#{KtWwa?%m$3U&d5|Hb9;9o;Ydx^sS>Q-X=1y`Nd6(dxgrJT6om=lA{S zPe(#LyZGkX55fQ9^3Ng3zwg6m(&6~{j=SxzpVIvP^4Kz0dVk-C((e^;aiN~GcSJA$ zZVXF51H;nt_kGCl_ptoGW>`wl&OR>FTPObg*nEh<~WOA(KGAMZI%w)zIArhB+X$pLjJd@RaKQyIlq^U=!#GD_O zRi3_5tx`qr4O&-QK8LtSGe5t!#c{;rR}WbXu79JIHEf2g{N3z%xOuVpF1w44S$jk( z+iggHc&}KWI?qOQ-bx6A0yWZotA)}jc&0^g;z>!SuBDG`yvO`Iua-`a-^Y#@%HLm7 z8r|)cL>nCKH=HHmK$-?Vm^66`cky+1n}NCm$2+|u`1WNQEdL7Le|e`D zUVLgeMQM7jS1si6Drn9HODmKb;X5f0hC)bYgRLPX$b()#Bf4;lA1^7DOM1js9#$6h zy!mbLq6#<%+VP1eGKAGh^2cRpGoO<{a|a>qY)+noTm&<_Lvv9GDQnhTjJ^f&lxeo| zZ$lR$i+>FuRlE7xATSvGon>+rjp>aZKfNGmmaaTptevC@F*Gd7)Lx7XwWn6zAFldc z=U|_EasT_?#6~_Ch%mSjwUK%J1t?ROI#J$sm%y1SDa$K0jsih%;whv5?(X#M>$tk1 z3kFtuW0p37+9B2u0cUwQmDb!`DlA#eCBkejTASv-zOfj6JKN_FfnISXq0)}NRN3=T zruMDl9gcz=;jY&PzW`FF*TFO=GAUC5?CRd zLx%g_O6}uMxcJe*F1bQz}>zx@KI?yH1n;3Zcnigy>?njUo$t+bOQEAC&`ZRI zzl~t;Z2*=#U&f$-ou>5Lf$FRRp6@-y>`iIsi@%FG{)HFu9m$5k$%DCn8^-&D0Q`Hd z7m<$Df8)2)x|)TdUHv}6-;MkX>+eSXbF}=QG?G0%FFA@IEv7GlSf}VV>7pI)vo|)_ zNWhb*W#}?ox|kM5p)E1vJbkk6CPImR*Xzx)_OX*&WxBbP)ct5FdvFx2Th9BFZrMq$ z<7~DSldgsm?{00>3efr<{8+*)FRw zDzpD}^x0(txAuW>gh3%d_=@QFXU^MSSShuK{M_D|$0%ARdsyh1N5hVct;F=1+WQkk zoHL`f5D14MOSfhcg$$ql$%^&*!jy1{Jsmx88@J#N-9n=o!`jAmX31B6-6qwH;KDbF zS{d33DyHJ6&{O+ae#bNPEyEe5-=7m?Rn*RLSsfp2E!Csfl}K5X7j-NW=P`M6WJwHW8@-)Tg5N z=#6~*;TZr}1K?4U>d})MSyIP8h^*ky`MZATiRpoa>En5eq$Qu*5$PfuPsJ0Y4!@`& z5ReJ`1|RbL#rbz|Y5^8nw{H$VhmqG>nYNyDzkH2{dmGcQZ;u(|srPHe`My4fDA4;j zkJ~q##OJxM=ugK3;FMo_yxl3Xa}-~BdbEc#dL*m)rxP9O4VTK4t#U!HM|^B{3Gz1)?jz& zSyCmKfCG_glJB&1OkU25W12H-`gE^iDcNgXk%04qwCBXcRE+S~hcC!vpG2*J+311+ zk%%#lg3&p1op~*ywQpNKW}$S= zzSbe$rmzZuAX6{Ck^B;-ZCF;lu=Qkkl$!h@axB=I*FnmRDhk97QJ?QP^moI!%5|KA zF@W39{l`l-I7u{jAQ64?h_T;^WS-$Shc;Ta*E$w)OU$&V!oKN7ftv{R}u0K85@XOxmm1>~rxzQt0PL!aN-Qaq5 zvadbjaIys%8NIsjp5!lKKA<^xPw;oGBbWhvEEeMOeSJ+NRmgRI=N86?FP%7u-1^5&!?@x-9P*D% z>!Gb6kJ-_>;^xd*)N46r9&2j|f@pU&su{GjZh_QFeo46_)_YWey-!|r6Mf_=bI^G` zD51Ljh% zYJD9-hk8Z4ASr5FH{bI{G>4=4zshfCF@h&seYk5gdJTUA#ZgRLCIA|))Y@MmmzFWl-DJ3Q|&{y6=0{ArY`94Y{;0M+B1>>R6= zGw`LF=@Yv)yVKolDHu%J@l!ei-dFr#Q4STBLs;C!-zlh+HlSeWVbU*8siOWmt)bkr zFoT5r&iDjV80Xt$&*fa}k=Xj(%-ymgp8_8TAzGMd8q=LpF!lsmHU(T(ikK8Mp9I^4 zBJd(@)ODGA{6J_Z)C#+Fc@0KZzhAeJ3Dz``7AMULdl1N%oKnyRlS#8BlM?KY<;=q| zYe8hbcJEievy(xSAX+WAyxxZ6Ii4jjbNpxoER+SL_Q;2okkCT?E4UfsnB6AUn zp-ym$VJ)Pu9C<{w{7ZPw{Rc*t22MWo%Punlh@9C^vf}_XDnb;r7MMqTA zf`!d0#b+=wM8=DEsPWpoaEYTY2|bnD>|b?Wgxw7l%V3&mlPO zuaGT1h4X#+)Upz@q1Y;Z_gKeq&ToCJyu#eP$yN3CHjRj#fsp2%+U9UdRCbE5rw~~i zD_9+^+k@RNo^%?Y^3(bqZ*}*vkPsdY7x@k+-t&rJwrCAobH7NtV_%0FA>-Lyd9T13 zeqS1wb9v7bq^)GcvUWpF=5pT|8?pK1lnNQ%sNPyDJt9MVm#zI8u5|%o+8%~a(A>vN z@-XB>(;FyZ$-3u?&_pch+B)iELHRiQTIrzb@CRBx@w)+#UYH4#FY{Q#; ze5ER-R8u#!KjZ|Og#1ux+!RPTR4#NBsHZ8se*2O`LI1ey1yq&7U8cZ_5MRRVNR9?& z$E4!5Hp#u>-5*4LqAk3PRcUunPnwU9#zGcYZgXzc1{epBEN{vbruA>Fs&WHfVe{MB z^fMJgkE=g2p^S)2rbH*p-F2Pvq;D^kYP6TK@CT% z7-$!Es27knsBpKdPoj*1EgQ!~PgQSj4gaq%`m5{26GOhtwaI7j+;oUf;cv6xa@!l*x#5GIh7TBFq3fUP6ZP ztmjBZ1aT{>qtfiQkVha&c}^BQr+0a8Vy!hBj5BK@Kk!;)Dh>k|qJn&_;MAlJst$Jj zY0I}ykadKP&D$@CBr82V=*w}eGSLfCXNL&uJLtMspHy+(mMK_FNV%Tl8XqGmSLBz# za^pna{McePg#P$D9$Rgi{No=(8fpbu6E7fqW=ol|h3BX}+@q~MPV_yJNLU^hU5E_Y zyQ|)kS?JF9uDz97^R9c4pCB7lNj;^*>LMQ|L40u~2Zd z)>_gntdFV-`Jmzzw(-zgA-!(Ja09^})4YobIHgTjZZ$t5$2tVh2>nu`%e8y$mpFXz zH9))$9C#WL%m|ia5XXuN83K=jpMmMC;GkCgz06-ZTPf&Wa|8xB7-g6wr zY$6^lzM9X1O>~zjniA!1ynehU0|#NO9FcRsNZSt%f$~oR`~q`Jur1GJzdh7xR1^w9 zoubjN*e|MEG3sgFtpwN#vBdwKc$kJMk^e@4bNG+PrtZ;u6xbp7+Hzm7>v>U`?R1OS zH(nxf4E`WHmgXo|*NfjL_wa_ES3ARz-$4`o145+-<=bM+R3Ar;yj=1rQbRoN#<`|@ zX7cBgkPA^5JpF9#P{o-%N2PazJyUM(O^(=AuD~l|OBs>z3%T*S$F7U1L0R_RGuMW{ z;WH<>BSWIKy?C>}W=w}d0CX)3)XN3RT<-MINnAqD@Zi>e2sCPshp}@|5!$p zGElEtHBD8%@czY>dnEY%zby5{NuI}rhN8vdo>ZQ;k5d&XsWyI46b|;E3ck4RV^gz)AF%vH#_xBjpr#fAB(0`n=1Ip zz;$>6HA2|IptPpK;M`D#`?x-7G++?^&_GsM*(-5ZJv#c1C#3_c&;cpqI3;ZG1U4JY zsAPH&S3T*AUW2{QS|3f>O5_Brpo<8t$LyQor^0+@46Ptn5*cI+f;_OLmn~}M740`| zP`}K=o;<{bc-I^u?;!Dmx37Z-wI}&Yx@*xElf;}7W-%z#a!PJ~!b#u=j_uicUQy)Q z!ImxP9}KcHxl<#7<+FygM2*$B%{JDVJB=>d{2}$YlE>qN#DLu zykSK>TX}Yh24uH)j4kL#1fo^0C2CK)2>^x|xF|B1Y`OH;sp{wE_)B9lAHzx zh1CU+UfPd@J(Pz6ap+Tk$nz4@&O+3@(`dF?vhYm5fk09YMk59V#EUwZI^WX6HAxfe zut=~S;WG~UHCn^)58rA&lg(DnzEv6ke8`xAj3##u2a})xI__Xu|?2==qcOE*<5#9Vjj6^Vm zA{FlGo`^wNKD^q9I0Jp}kQ)R1otzp4{1Fi{`J!AeAP&bDNm(>u>Z+25v(D2#`z`r! z3R$d{`_gM%jq)Up0R9s^2!N04YxV}4JX~hUIr*`vpStn}LSjuPBj9!V)Td9^R z{2m?1^elWT1%+Nf>^%n);!Rk_jblXcI!V>7e)!|j%0@RU?c!V!eXl23@EpQ?=haS`fH8Gll}Y<3 zkHvaU)ggRFH(y_KJlOK49+=7eoaDWyAdfWINIQIGEr{af~qNQ%lT=hN@D+*>PfGSI;-LqioBXg?>l9$@UOM(P;;?&4B3Izmkx}z z-FcCQsxj>vF989yW?!V_5C%OdZROv&7Q7|>0xVxM0=I8sn4Uacb(6UbzcVki>EJJG z41^E-jV?Q8V6-AxEkzD9ETtgej?xIs=Z?&TOZ8VTB%}32rp4J8Zh2PFx_|dC(6xA% zc^I9iT8hb3M;80j^*!!}%r`rIO?LsgZ`n36VRv;^wOolfkxYMA_{rR+bV5I$4 zk4HMAImRi$5u^nW-p4U*zK)w|x~zEO@#eSIE6oHNd`tmwuo)QxT-XFSEDUWiwp!9V zUr#Y`J$}OE@@-4GLNZR8$M(6mM*@!zFc!cpTfI%zNq8mxqtp_l# z6j?j2zsgKRJ9xBeDK!zgR6WPe-0iwH3gan~!gEYo+qWnv8$pQJO7=n*66bYHqJ!>Q z#mre#({_&cN{yfgQ%;BS_0_(CC+HT&Fhr=;mXGcioNl~6rlr#;8uuw;D=rW}yTz{AR+_YJ`%^6}^LFonWZAN9&+o9) zc-t>%eJPGI34(lFJ_eQwR$aSat7~3pFz{b`0}JlD{fLsOiC8z#>P_lnsriUS<*=v9 z^{?3)@C(@unt3lAzI2S|HSwl_IyRSzCSlVG1je@ezuetPIrDyt0xau%={Lttm@L2e z@n+K!Abi(!ECJP37?=_Kj?&28q=P3QVU91LMSuEeB+FRMds!m|5eN_VC4_CS+56QX zB#C8f6G0gogC+~K3na7W``Dp`5sp|HV}2kJ1!=7hTOo5`VlaYm&Gx-)UViDoy`}Y< zjY45V-^01V&v^8SF*>FpKN&Ab&s{(%tnQ)c^ln@!-5a;j9%e>PB?CHyc9^1m^CeG4 z&iB44)3^u#H1pq;4LwlGq;i~lZSQSXjal`4#8E>U!`oCB7BG~BkVJ$vNinh%0mwOs zY)A74HogEgLRwOCehf85COb0(yP1~Onwy=hXE<0; zcVyA9w3dA&29}4S=?WS`A;p}5D%4QNN1=>*X>(ZW9iQV%8!vHWK=^an2ZqXvr*qy8 zp4L$ZJNS`9F+^Tz|D9`@sj@*?keiD7wq>x6)M)F2w909-Hh4h~Tj1+4vv3K7Rl~2j zt;+MBWlTW~ZF%m6h4n|vyO?Ym18{N1#R8>5KHV<-pk5%=$Dn{KKB8-x6vd&t>yZf9 zLczIv)R_81Zj4$tSmU409GjvM-UU8o?tBekDc0gyGdl#4Wv-8EuHNZJm^0w~GO3bh zP*)t~7T-%v09KI&ld~&2b@3^*v9%td*K6#>wwg&b0^S_ikk}o792xdf&NRtCfY7wg zihMTshlb>CDv^*ZUQ1OJ*Ex|YYx#K4b$K@7#9d(hGAE4-GV2%=?{lpzyJ<2!2YRKy}j3V+R;Oy|Kv>%V8MqZYt^gZlD|wU zUMOHnu-Y$*nH11Bnh8!)0Gl%$wkDpT7|KrVLJogt5ubYrnqP?wg?(rC9cZY#EZ9ym z(OgXe$;s1ct`)D93$-Qzbf%XW$juS#j1H^0w6nqNudsCv7@`Ri!C7Pa`v?qIii zEU2|a1(D}A5)g2e-WTv=V0@wD!7%zRh*c3JNOol#pd27!=+rIL?O=)&X*g6F2beG3 zgG4lRC)9PdxGf8i&e`$s>9j_9&H7-9&#B^ss;I7E7@w&xE~_iZwMqeHlPUg9xeK8u z?nL4W1&@@#tIip0O^uAtszg8(J5j%Z#>21LP5f?xQz?qXteYTUJA(#XujhPt6;Lq*a}{oJMoc zM@8M`#yO#)q1IQ_8ZYgT)FHN6BRljaZ>Y3xApD!_Yx+&&vZ)@hB!`*D=(2PRPdu3v z%{Tic9_cd&k8;l26I7~WvnO7h11r7fre@OBUyff~{MsH&Mg9Y(B9E>H97pYX^Oau_ zA)pE@1Bx^1-`Fuyf_)cC;#v2}5ZeDxV)}QW{^Aa1p1?5W`SlgLLLGS!si2rkl{-0Ec|65Xmi8g=hcK%#*{x^%G)_K~C z+nMayM}~ecWWrZA^lzj02e3bJ&ELYqKatPh z!oxoz&)<0GZ@lxLYEFNLi@(Fge@Gku4i|rii@(FgAFJnoeDOEB_@i0=4j2FLh6`oO za~SP5sF1AfATR|D_@TD3kBdUXx{m#F6^0DA8p=@@vfY7h)b3=FFy9gMS*cV0+_H03 z?e-xA2x@VbKvC&QJrAlG=%C(V1liRI`TP9mW2sj>mNw4NASG7b=@L-eIr%WvNoH_# z>V(`~M)p?oNbR3KkwTq5p-&rZa+=$qejZ?_YE?Ek!iN9J*N%K zXW?0+Qf4&`MQf+3c~VOC-XnGUHGs2L1Bo}WWddH+zxD$7hXso_>EiBwY*D51S@6V( zUo$G)pU3a>F>~&-JK`6M_MnR!4K}9^{ZibmPD1HYc&8*>$cieNs4N$hpKsfh%gW5we(qLk1&1&1CE0Y|tHvz$X@lUTB zp{f57D{hRj?_p^>Qy3wV!(sVP;PXEt{ih+a%B8G?fdf#9&V2+G3g5EcztOJVe({f+ zct}hzbOS#Kls_nR9{S68-%w5Z4;bQSbcl;TXV&^k5tQL4uFKM?b(__W`+yTU{>fWV zHJ?N2cmRul7GO~p8S1ZQtNs-guB_q@$|`JzKz}pLJqm_eZq>?YEe~*_-T%{x_Cn|V z702Ci`cD`5ay3~0oR|OOq=T=ei|Q4C>yD1^f3%U&3C>pr7MH(jn}^jTi^Kc)&mk?$ zEPq)0{AD=%^8B!_HD~-~GboFk!#D|CxRkicG}R0v!MMAH8F&9%?0$4lWZ?bj|FjHk zHLPRA&M}6rV}j0$eP`W*LQNNkWC@}uC4m63wE3!1Mhk_0m%sz$?)@`R=2gY`b6oCV z<{J&L3}8sDXT49m;`o+;|G{R&7!<5DzMmTtL~FdaTMc?jH-n ze|n*Tsq{UCfV)!>9=mSnF&Eteb9M#7s69dNgU!@*0v-&z7|a-2qTO&;7!>)HT>0ULiT`8<7?-e%0KL)jY<(jo}eNS-v13=C87E_QjeVse%11k9#DO6;#_x2a- zZ1rg7(`uvz$yAr12IY_@4z|bb0nLlcC&P6`WWkff7RJHr? zPcGyj$u6!sq7o{-} zc+KuBpK9K)!uorlyFRJIh$@t{nfN`QGt8;xl1=C9Z=T6ZAbk zuxQ|0ZN(Ier%;7%LOaUNml7RXsa3w-V7KrFR+dEr6ZUCzE+f%`wh8fki@`uZ=zO&9OEx+6N7 zh;(;cJg}cRE{Yhc zjt#2w+=tT_QGCOvtIf!qRma_ah5h1rj^3-Y?&i!kyIImjr`Y)-Wr^hfX0@q(275sRl9Lm)IH^;TM)5jYY7 zTt9*(+lNFh`iZ41i2=KNF^&9G50H zeBE4pX*p2+Ax^;EVaBstd#>`6AC>puQT*?3Py=#Q75_~PobN!v@g;xS$fZy z9J;)g#?)3{<)}323zS1z!_tlXw{bAi>~Z&**MkO5-7pCyj7Ax;qK}DNt`oMg7V%bD zo`Ymfo&v zoEXHI?R49o@|h3Ei?&J^@vSRqwtWR28iXZx`D<$y;Db_C*5XPI!8o|$;h*H=V)yqO z^0eql@Npre_9F?TGwi<<%wDVDiJ=xUW|66DBcywQxw^&nk9hB@a${;&SxTD-nt)`?H?bZnxm#F zJZpfXHH)LD_T!PgzA_QLWUc2EvH|KqR7$OlndQPWQzY7d1q3`5FoEp9GLRik+S->N zKd2J|YlvV2#Qe>Ndd5njbSqxm$3| zUol*7=QCCH{PqeM8P*a&gHr$jdojRx!ks3;S@jNIy0+D?sQUI#g{~Bi+Mjj(h#UzA zj#le4)X~Wc}FO@CGuW%<9+@;mp&Oh6{O+D0!BW?(a^rJbHFE+{O053S(=^uECnDEruUwV zj8djRKMi0ko$;s`1II7EDR~fK>ya>Ylq}O+uF#1)H%5$LaRQ#aI{F1s_x4^$I$R8) z%hSWAJ!M6)AT7@kWG@yox{xCKpkM}mt5CNh8Nb9c>7Z*^Vp+Zbg0-wOGU~Pnv^z^W zto1?WUPAj^dvEdx%cgd-L|j%IBuDpa7bJ%F3&mqjUol6>-Yq!D{A)SZJ%59*@5viH z3*_%Ge!TQXH+c2-BPym&UM_yJwKmArB&#<~Uqo)s#h$=~{0|iOjz2&`GLA4N zv?BMe90L-mmqryip8eWo{+=G*ttfeyfSeB`TXFVa&v^!HPY+;O!8UpNnlr)d z7hGCi#GSq5@n&qff72x_lmTq~;WGT%n!>^U=vIXe8)2g);zk#cuCw7$FB_r`J;1`0 z4V2dCNfdVoB$6c|TG^9UDd{6LJ%2JxX`EUO_TXXI*wJE;p=&P4TYO;4elMjdbf=&G>enrMw+@2TsF53y&T~^;#w#B&6qY5PoI^vy_J) zeUk)&@_;oSb;s+~Xk3Vj`!D*l3NM%8~eeJmt>JDDb3)Tbz7R85*T+ zTPk8|0~Xi;2m2X1Fg;SoZN17uL>`We_Z>;?sjQZ286%U3-OIAO2mTy00fQ51q z84ifeM##o{k*s(F9eiGSo}W!oyZQz*9xcL0PAJmdV(Oq(L>S#`5}PP}O~Zbwqsgrl z=}}nm+L8+qB-beeM}#WWapEaDn%a7otVtL0u~#>rytYB?lcqpx2OW&l#1w)0Ka?8f zxuqP#)x$+pF_`ZJkZ5e4@<6!FlZKS7Nj81W@|^H%DbR;Q`B$fZ#8K|^;i>3(xF>4S z(PSbJZ-Shy%EQ>1)JZb!ia_g(I!=%GLfKE6ovw1>$s;yg#naUp@BGTs#;b#iQF^Ar zE*#+2#izndM=_TFokn4!2<0J(^vKKf0%BI?Fx_j z^B;KnEGZesKRSrQAO$ltK5~fbHa%)<#4+o2H<9M9cY`qjQ*RL($qC-7JvE}kLRM$i{T=b7W_K7m87 zUY6cKF?@cRvVM)6ZhP}u_c6Zn5PHpC3U$0UQwZ!ms8x8cIHzpM1_mUWjRAl780Q4g z=-!HvXC=Bkz!|>7jdNj(6pcbPTWT8Q=+l*_>BaPDwE*Wgy!vxL?!(WaF^^ly;e)fop+wDZI+s? z!4V2RtKyn>OS~D3)P-0O@PgJi09%pTpW=65s*W+t6Rg};$m{!hv9 z9>3I(rAk{B1GDp(4kSA+hTO z(oErmT97V)A^9M#e$a~vx}fM09B%E2QFePQ z23m_XJW<2!$&xY=D^LMcuTjRT+9f-EH)uySi)z~FyfVZg_lCP=t1}FQ(v6}<05)+3 z-bw9~-kE2X<|EJXn_#hQMzP`0UK>`$^85*dW zqa9w(?vI{K$^MlKF6jPn->B_AHkXQ-9n5|t9ZiFpJ3o^cK!W7O(*+6Hy$KE8ijIig@MK1+LtaXE1o_D#|nBJfvjpz zeQAv%*ET5L>VgRk0B&e%bsi&%?)Z_FH9abKT)`cr`k=7yZR2%q{#-3I0QeEeTeMt3 zZVw8vG*#N{fzQ&`v+dTDI?4(E#u~^bx}qsl>HA1rfs-QM{_zVF>yS7bfi?Xn)`S*_F8^WGA< z{77Ks-)NFP91Lw>GL+MQn1nPKt|>e~_kzv#20+3;7{Mr;l^f5{hII(sMa*YpUZIu#RciWN~Sjo{*%5Jto;}hY7{I zT;O*A=W_9uTEXgTg+d&M{frHGK72X{lfJ(0F~(iDI}pXutLgs=pAkjAyL2aFrfjOB zl9FUTxc8$xFUxI3kGpBhXdUj+6uzJIfk0q=-t|AYS6-L%J*VC0mk7{41>;Mh9GnT< zk{d(0j?X|c#9e1T7wgwP&w&T_R65*B%6i-oYwTfow7AZ5hSh&|GM{ZV8%&=4*o))e z)&btNfAJ;CUHIhCj%Bhno;NeBvu&@hY3F($4W`&3c*&H931;2jK)4=AVJzf`WxOrY zO%Qa9grtbN-=2cEv<8cI^@}b*k+sY>iK8#2$(Mx^&8O_980d@RF@ya^-dRWc z&gz)G77}BpQeM|vHpjULm3tZG28`4w7B(X4LG{-ex)EUGg1hQT>8C`q(zT{i9+e3{ z>6e-=*|7{@pXglzet9*I_9SbgV@z6{Ifus26y%r6`5F`f3AoqfOt{$((fQv9`76i6@ zOXNrSxS8)Sh`23RdKu24{ERhc<7DhAJOAjqxWe=0W4^u4CzsO`Y>wA-rBw3@jvAH| zyPvZq63@on=FR)FSK{E9PPq*l^Z{W3|6lFu61rvSSvJRrtLK6LVqTl>s>#Rf_#k4d zx}W>6^va5tI<`EsNH|W*(~W5&?>=^9BHHTDk2Piy2?GrJCkx-gzWy%1%n(s6A6m?= zRw;Q4>=(cuAuoN}#Hx-IN;rv_`-?fnJgDL&Fa;zSDloV`uPf}Kc6 zR)*oz&*!_#9lp7)cuIK$hr(Sjh`>`F_0G6Uq|?dVA8wAbHXBOVEja@6DSx|>{8*fG z-FqJR@fIL}#?4z_@AjzD*Q<$c?XpcRm}?&wkDbn| z`=ub)Z2y?%($7AXl49y3Z`6bHZ$F}7sv)KhZ0A=FBa}z;orhjH$j1aBBB_3BBJ1YP zA#vw>ZEt{StZ0620g$k9^nnhvo#~`JMovQh7Ip6L3@X5GrDgBv(Y@pp%kq&Yub$mL zc?+1Eg{13`Nv^5oF|>izXl(u)(){piu^Fou*BU`5<-wp+1asl7=h!HpS6Ir%YoG^h zM?ze7BAB|Zakkhi&c;Vi_rry&#^p;kxXQn#jcrJ?j5m>=yo4>EC|iNMGaDk2d z4;MDviw{AvTzAR5)GzPOYnowezb}bFhVN!s$B3Y_5%3cO5J9@Rku95mAMEEewk;cW zytlYz;i3Eu>||3QPAJ!=wi`<>fY~1mZi_K+0g#Y6W-r3w_|0Y1kXCB40prYMQBC~n z;QRlv_m)vnuj?D|7C}Nv5s?NdY3Xi}2BjOxp}SK+L8V(-x$>mfdDvopR=B0)T2}LPhiCwLnQ9aj&hrsn zH!|gHKHFC}Z%sEmkD}_&5qgBndZ;AQe2}NPkNcnmO>>kLK_wp@1$zrtD{Bhijr8q1#w`t$!E zQrd$Ox!OgIvT6_sV7}ca88I?X^$t|_{g||WyZ;b08_d4=B7BWMU3XN~PU&YP6RdCTJ&7T0PK@06tr8wQ7C6|O>+G8yOC~XmNPVlv3O=99Yv{@)8j#d*(&Ak zHUZ9=WlHto!lKfoeYxq_Ua2tFV72G0aKR?de3BO-N)-7 zagy(DW9B??R11qW(Bwe~!g{YDyDZTbeSeFS*Y4JQxmia8wDS7-` zO4puCxk#N^X-1VLO266DV>0 z>W!q!9H>#`bA(0iw!r)QQIF(0!bwfn1~Y0J3q~L2DW+mLt01=4Di?iP4+**a$u=up zx3$^g3YKkO-7( zthM-@RzlaB&-Qy*g$CZ*@_L`zv#EJ*3HSEc!+Qk;M$=KWDoj2qH1BR)^su(_7A=D& zIk1jWi;S9^`$GCO@hDRSK+7nMR=1(@|7Yt8q+?_WJG7X9r8GVZ^B1UxKv+ZBF`&sekOCGE3H zK(9ctas-c-&<8UAlS(Q?cNntw1H&X#d?kw)d? zWn zoDRG5LIbY3i*MdD2&UC=IBidJ5!VeyO1+3F7&Z*NbDMyrswj{MHrP*uJoG94#DlkE z@XDBN%<=-|>#SIKN4=d~JX4fx9K+Q2R41krH>^m+=~9IMWs2iTPS~&Ojz)pYkJ7DX z`AEQZJC0{0Cq7OtZ#w1>+l?uOM{K??Wg&ykZxLoNT<4)NRe1t6z#YOG&hwH8!rpo) zDK}O#1IKW*p0AM5PJY~#=(K7hvMTr1=qyJ%11HC#$JX_Z7`9ZqSLWQs4q%-RMgA7Rc465#Hw!M*z!&y=| zY!W1$eaSpF20m=*91z7Jf<6?CduZj&>e7QYRpKud&7_gLQUz);$pkffBUz1t?tg^e zUZ)6l%1oB84%Kh=3L%vJq7o)HVPP7xzuY6&6VHrLBeX}wBctogfKOmhrV6;l7ipAP zs`NgiuZa!_GKi*CuuKrzl9Rs0cPLmT9vI}^8%bD$5u{=vS)^$mhc9GTa=4f_t8bQ% z-$-7PnSoErd1xF&^-+zpiYU13Yoc%Xm^`DrIsSt@qF1(dL4_aHM5`R%@$;+L2a=r2 zZ*pt&W}6#jlx?AzP)RPm1ErP2YXW zy@`rFx$2BKKS~=r=NrM`^b{h>?@SkIHIGaBj?Cu_(H82!>@eA_pTAk+X&hvKmm@m_ zi^t+qM?w4&w&U7ygcJ0TBPUMbaLPfLyn(fZB&%a2or~y&vG`xkBQ9Dp5-JXY9_8J+ z+Q`;eN%d%{*1Y~3LTt$j*dzLhQfMT`^1GhM0Rec^r*z*-N#TO4MBN5&$;?E*g z{ms_7N4ijHrH~kQdaXbHpOy*iP|O&$X)O z4k6%4oOO{bdi-#{VW**&D$`XKJ}!PMJuaFLO42g@WAYG!>#O3yJTj^LE-x4K0z3^r zH``4^&*UxZWQvv^Q~t%`qP_C*CuSNC;yHo$e13LxQ z&hT9VxfI?Teg)!wXPNeIwH?2ICy!oRMrL=I{jKY;Kbh=(PePgOT+p^@N57D3B4{Ty z0fj8LUEnX*6g)^;o(p9+l=nO6xp}3Yhd8R0Fw=~yaa`HrYXp;w!_4u^9KS;M2k_g} z!RX2N42y@I3k}5Jlu~fsK@+=SAQp}*_!{E+s05SE=qp;IUy1ui@3Vb~E0b&JZ%9`d z)|Xd?@l_3Yc)xfPv{%eGN*tq(0*7-MHq_|VGCzb8jgLT4w&o9tVi`0BST@JzR5$Y% zG)meUM>1)wvbBnKT!&7dBeKn-n&ykPFI-f{mipvTwwnYx7hXwbCb1Q?LQhMmW#3bL zI<^|OiE6-_o?1rcL)t63+N8HprZKl%Y`(^B61gEZ_F)WU>>>5887qrn#plaQ;)-Bh>(y^h^ zn^vvxoI3n%bCcVg6^tW(!a$BGnWwk1t)@Z1;sv!rP{fvzTjUZm-rnGXPPdQlla>dw zea!_nc9WpwaM|2=72Oe8_N(|Wu1~x~)Z8Zm-0XAI2?p*z_=Ex(C2fL2s?`^f4N+=^ z63HgA=WIb+MF#zNF~lsfUyIh=K`Zh5?KTh3%iEHFe*5p}$bXn|>aymCP`?wK4{Zov zzGbWRDYrVI?k^sAu(@8s3sN?}g+j-*h%DvD1}tZeUqt;jQ-aDUI$qySpgw@N+tik( zCdncA<5CqaeCRqCA_8yyGB<{@6jd!!;Lae=P&CInQS*nm0Z1ZAmP6Xfj(?W|4j{nupwoIeW8+poq& zUcNR|RwVs1D)Gm?vo-~J?|n8l`+}6w^N_$~b-ewqfGbmD>ZO3e2G2ovYNH!?f?Ra} zuLp_TfAE~lpCWjZkh*gLDdX)=XDj;P{?9dQ%TD3{WjY6RMHx*@5Fe_*6scXiRg4us zcT+i1B-51?$>SzZ7dz%^tJsqi;~j7O<;fp0%5^Wu5_w%;Lh4UKK^s25bYaHb)$>W$ z?V+5U(E`08FHrM}&nI}V_m|iXcLh0|RKRS24+M}I8?)$+b+)Kt*aT<_zwE(312OSu zFD}2t4OiH(dVOW1^1OEDb>_ZY?4##o9*2}|wB38pRjgZIL*--LIGRmYJHpc` z5vXAw4>($hSn8cjvC7K^P{ZPemhxtnQw2EVZXFeRo{tufXt&H927Y}*rssR%8wElw z9_x^ih4f^e9N#wViZeK=>(DSt%<^{Vddir$)Sn{(ugK)Utw|wa6v4M&(f+c0e=a*E zwf){;y7C8eF0ZNvvqv#IX3{YqMvYSa zm;}792}8MGq>il~NoZu56baQ6Wo z(>d4Zww#xKB6sC)44Z)Byj4FMd`l5*`u+B=0~5^n4XiQ6e_3bg50G@j{Ty_SwJOgk zXPE?Uwa5tF67}0UgjE0D>NN&Op&n3{gyYm(Z*Flpd$K87zXftM-8y%f#rMKXPmki# ze55-41O1TE9L@daT#skl`K|Jvpc}*&O_X-^CD&3bY{arVzaXH0o*S+w6}fa3bsF?% z@G1J>4zKIhd!Z4NuISf=9JIjekp9bT|I7=}+K`fY>}nwC0&Y8xz48BYa26!KA8!jp z(?IC!9hVF5F{fyJi`XG3z74HfmMVbe2V!X+?hHM(RAXJ8@|`(O&#pzcx(+e0oT)we z{7nYZw6r-9Pv)iLbkBW+wZAE(5Sm9yxUrjV2ogW$^IeRcgIHE7?C4Hq+Z3JOWmK1^ z*QzPqnt~I9v$gn_v&D@pzUhS=KvKFI{LAJr)TF4oyupMS_*sQbfmKgg`SxPJ}6{0C|NaAb6UospmR^L?z!U-##q=NDJ>dp&Ru zyLW(jCSwCp6K>MKhVaS|*d^5R$MW3;RKJ|VKUd@W)!r=HtML;w@W_Y&?#f%Ygqrw!aM;jqN&~1d8E*&(44P*kAq**XTNF8U1A`{`QG~d+Uyk z0@6?*P6YD$jExPj7PcJ+cVTr7h=z-S3s&)0Z|;I7(-Uf!JbfVqtljZ_$Wt(9oqc4jkH zvw89Uqb>i}ETG{7rz?achCQ+LLlBuyF_oXb{oTF$XV5EZN7$nZ%WZy{NDBW=S&14C zkaE)NW!9w#dWh=-Gufh7E*(uRbGL%-^H2bjJ*@Lifo5swY_pe!a;|6FY}xC(AReT! zyQ2O%vM!HGW+b#%ia)p6U_raq-=f`Lr?cgct+Kl3f#w)W!lp~B@L;#TVue{pW)AQa z+gC;_y@?#kkFKQBByh<1kNR`YeI8`GpP^eQzehihX3UllJ}1zq3h!LG>Hwx&3gA48>THo5{NLnO}k zNO1h^DRH&0e!I`IS1#)hB#=6|L9qH9rdI7dY)faGdf;rrx3^R+dZbix@x`86W=>oak0A(y_t!{R(_ zg#3FxV#o)Qn*tT(Vspc@^n&ccTpNJ`t;U*ALLu325u{X6R8moDRueJ-$mqHnB;^Hd zLI8p%cU<^_A`|uSb++tL(Dfx&Hv}%PqCXsq_?%biHhW5DJ`H2&ipfKB_N%pnMoR=^ z_k7Hfq5(h&l6~XINvpafK@*>Rlv0~jCg{^s^+B6o=@gU`WP6Q>};I_ zjp3IkX%d?iz#vE;Z}Cw-4SkTd%OTqm-aDXSYsX5@zJAoquXJjdt5&SikN|uA>$1nPZ|d!kEO6t9HCOUV9GJ?!4!#=a29p| zJd2j~7yK@h^?m#_#9C;BpAe)bl$=MMCF!@fC)o&&R(L67==M;i%xdYJwb$1@!~Ny2 z=*k6-_-DmFsKnZdY(5R>OczV*S02A$o*~wyej+LQ`Tncz+hj>-R6XLE!ZwR5cQ;wD=enKK;Z}ITiJc=>$*Nvl+bjn zeb;Zsdgi>D^P;K+3$0kYQgOV@fX?zH!o$Bzr3DEE7Gg+c?fy`1#f`e~hh~#=J&CZl zw5RhX!|Fh4B|`u4LY#7rtXHwwKngvT6m|mfMA^*IIZe1sybF)So_YKI6V-fCUp}XE zJ9?ecCgBuEBanZECZZ4UL5|trV93>(5%&-SzY}7xxXP0en9&yGRk}5D?qUkBvB`bc zwproaF6+lSnX0Ibo@Kc#>v%dy`Ie9|{vN${ue#x&p;imrHV{igwLo2u-+9Y~2i?|h zZp~0EoRv-?_D)+%Ib6}U@Z~)w)k)R#I!Y_`vS=sB!1VIDqy){`{_+VX-cr+hCF4Td zuOS2)HCKCqUpds6DonZf;p)-=~eWU;OG|m7ftE zYS+r_cXgDoHPbi|gjO}(mCt5OE!B^6v8~**$7wU%86;MvOj|}fp3&tuIF18yQzxm64|U7-jNt#*11NPsMiOpUTG3SrSq%cp-J7;ev`6{&|ZV@ zB>k&y2>A`fL^l}`nultnar?gMaF!R(&|vVb7*M`uUO3joA{B8-4_A2oK(90-g;F9o z@#P>~IHCvRpFQEf0-HU&!Kk~lR3xwN6N3O;;EsAA2_OXG#+j35iU_$}QxI4_tHXyh z_Q9^{Q!91ocsG%;onNcBtxe?BVmb7}U0Yfi?r6V$(LCk1Bj`b`UOee4@_D(`$x5nW|7Cp%uEM6=LFpfw&e;X6A!=HmX-x2j_X(=-E!rdsJH->q(q_)h zqdS^Q44i!qypn0eCZ*0Qc>^a#@ zHlctL61u`G(ehxWpwRJRlC3~Jr$XpTJ`q~&e-~nKKBw_M(H3Zg&2vV8G0kVaNCY$mf+*Hy!;B?bd8{GdE4!hYmmGqmA@tdYjb?6 zynW)J@o7`ZK4Wn0?E4o<~IAh@U zov|~6GHje#XOdvoa|d)o-**#KDyI}jo~k?Z@{@SR%eqqS`TEwgroj9Ciu^TpbUg~y z7^y8YP3_(fmIR8(&gak_^Vh2gE2%$v$n2y!zYiOtlA3If$@Qkusx+%SK*c7Bl*RAv zy6VMw`APrWDla+ro%oN;*UJGO&qX}9+`HlgYUjqCnsf0dF1`I3ED^FiGfRT_Lcw=$=d|? zNGm!>8-COpmp!$IZ|1gyH=8eruaCEvG4#H7z=H+q);ER2c#2p&<+0G}(^u&{^qny zYqF1sH3sl#31!ASR>PXyi3>W1leY<2e|SvF;L&w`h-s#>%7v~qR*1p`uXD?KCu5c*$H`i9_{N+wP^sA;L zXpiS&f>^4flQ@P3l#mkkj+&5#hu6`TC~g=ptS6g{?}y5=jOC%oliiy9YLs zANFZuaQbb(6EqROlR*Kp*wwUFuTvlH(?+RNP^&zUgPE#~Ult&W<<&#suf5cfnz>1?-FbcwZyK zQ~1DiH*n%KE$F?l$6~k!BbNrpGn8zy@eIs9=SQ`3O@SmTklt8%Gv2UIxgU`Ew5zRI zHYZBsMlFUrc@79}P4?v~5a(zuJ#{_n<#VEu2*OMgZuxT0sWr_w`1Mfu$KJ=R?Q*fP zfF|q`NMuJjC*HZ<+D9&1ciZ1}zg_CcHvhQD{^C2uHqlykTMDPe=%>IfU7Y$h~U{Ke7G=<+6naajlM9p zJU#0e{cve~2XP@xywiGbY2UkXFCyFbWC9UkT=zW_Nz4cP3tS}kT!{H1F?IFRuFUt{ zM+>V1lb#)CjX6-KD_*}^*ubQ(>%|;EhJ?{~Rw?rRZe^uISKqYuyej)7<&NOUyG$8` z%)t|c5W+VyRvCefXhyRV3x}WVCMV3F!7l2Za=V`*73g)8J$$uUVXad1M3-lbIhxu- zFTPZBofS8Ov}LAT3|z=&8+>kG6LE(l*T-VM{CU=IZC=Q=tza9F70E0GRhW*@>L`4$ zswK$TmWLm;|0LA)95@oJyQ5 z{_+H(buwY&qftAC$?hdV9J7XgQt}2d|LbFl;Iu4k`m8I9y^h4Y&C!#$uq?+)NhvPy zW-t9w_&DpLnR^=dKM5Y3ldK(lx7sJO%!cd=?>i(`)NFznObQ76{j-l(=66m=_>Hoq zUEd_!!Xlbl9j|MLY{e;!y4;pY z;xCBz|3%RJpRoXv$|dlNcBC=l+-11XgJVKXuz}BZk-962>P5~Qom$(jq_HBC_WkAk zrDO6Z25Fnw{^9fn3NZj7fzNo@pNlYcI&>f-P1o4c5Vy{}I4P6Jnf0@WViRPsb~9=e zFlmd!n<3cb(|a88UYc)fwJA^X)Mc_$nD!=*#M@mjEl{J1U}gTs^j-e^wred1my! z)nz9r-U#m5Z%ruTT3itBFoBsGrInkQA?&RXv2j&S(E++@NVehB+RepZpxo{@$Wu%# z#2%vdcy}+lRa8tSk=^t|un!UI%FVftS`T6=I&6#+w}n~_1&FvT7_f-BY8r|8P0Hm{ z*|qMro);GDHjhtGBI%K-2awFu`ORW#Ja*lBpw;61R!?^q_}gNS+q*26E97G$<$(41 zpqn_HImS(PbYZL6s;|v$XBolg1tRN%zS^ye5np}IwJNhCOF~Zjm%2^%Vwq3gK1{B? zqyQEFwH;og2~sG0EC8}1U)jH{>#{Z~S*TjF;gk?4Oisa(s}!@wX4HuzvU4~U@fTgd zf5NeG8&Ck;x}&5C!uZJy&7m(fmXhtVaXBEJFD*i!+?s4jWiqHyty*l~aM|p$XJSR! zf@!mx9X`Tac|i4Cp?t9;RRksf-NFV-%k_SJo~4aH)d-33=CTPg@jcNyVezR+KMwKO zy@^88xj@?RfY<%aJr?EB9iz_|b~#eDrAFl@zdMRuJrU=5uXGg!d)gTEL1b==HxwYZ z-zqdS(~S2#62TfQQR`W$@ZHvyNu>?*=I}Fod6dj;6KfVmJhjZR+8c*S$nJiAilO4p zkIb%;=lT=lfpwnwhbBK}izK@wINR9WoYbzCWc)@gA1ke1tZkgO)OqQ4dQ}3LrY=rA zZRIPQ88>N6Jlnx_Eg@C`-;3uPV+A%5Y&I)QK&LD3dimUd3?DYQEz*nd*KKi@!N8{n z+9aH#dN~MhIuEp)qOvt@vyz3g_E^%bQCtzXyB3<@idTM5JHe-)-#1 z1kIV%nJo{oL6WzHVS9Ei8(Jry<5=5ewr4nYmapJ-SI!Zuv z!vLUElZBFEv zyft!MxbWyoW^KhJXB%!V$SY|ZxyJm`Ts5&Boi`@+;}a>RWE1Ean>|l{=*E;08X$a7 z_L^b_V#YGQJ|Xt5jmGpoqWn;edjkBk|7DQ!zNuw&NG*7IQtgO{H`7+Y0cTz z_4_x@f0Ziybq4=1y?=mWj6c1WTn5rluazklSP%8yY>57p?CC@E?tWAZosx9)L`?Va zGNbkDFc8CcpC4^zYgMl7KiwEj3p>hjPo1uY4Sv3FedI>;?vn@WS?$vah z=(-<^7Am&0b(8>WPKaZSpK(pFoy!q#mvx;#t1$WTaDBKS%jQ0lswTh7I>V2pj@oTh z9J0=u5*^doI=21QC@OZV}dXQyJ`l#T0_;7&^3YzJ|m`?Doc8)OJ3{X2U-=*^-U>{ zGi=TBKz4$CaoI>HzU)-+yfXKiK7k};rni&LHFhn&zP%-+TVeegGM8nRaxmlzg6M}+ z^L_^5WQY;f?{!Rx>~J-sp$|$0i|w%9#F0$@2!Dwn_rj{RRgcPo!r=mA)Os`FBJD6^ zprH9iwU~w7=lNf9m!FgnTFy0b#6w$*%*W|G1YD-qF)6=G6oXn(L+MvH6~9IUzaE1; z2Ru3%fahlCdfaGrJFykG_ZoXSN>I|V-gmpf93=t-R?>?a262FjjRa!)5F(VkR-wqV zePHgPeh8X4hWG?PkxB#MH*B%}cBVvd9bL)O#}@kgyK=UBFBenaPDe-Kb$3ZSNM@Ph6ns??ezWZOplGPhr**1-? zX^;IY$z6sIlG)GX1TMl@G&&|%&N-zIBG3cZV)+%c2{~+2sO8t(6f*ca9gepM3!ar0 zlWtHY6+DdQvf}n)RZJIV)@EM1Z1%cjhy<||3Y!7heOR6SLV)wupkj^Pj9KHR2Y}bb z`xBqVsEZEKw-B=D16bw8&QXjYYg@1nWenXJ7D3EIQwEu3lzwCh@Fg&0hRGB@riXyL2E}+fq~JCZ(cUlELwI%yD{k^+1?wsPQ-*8@^*W znb3wu_;8LA>rGTF^zp~SVti8PzYtXa$+5f??Zg0P&LcRELMrAdmTAw5LQUbfl==hf zPhVWyu?tS}c;Hski_Ve*8ipfDnM z(W?wKw15$VlV!%vk3Sl*R@%M2h@&5zx7!oD4qgH}BEBbqbtYlrIuih(!1Ugekrn3b z%RH>A9u8s#iIZ()zA7RqI=uMxk;a6rsY)H&WDIm|tcT4W4*CVMYV?MMuLP}!ZJvfb zplrQ5PR43CHz?tb7Dgnynn$vm_Q>#IS`rfE1zAoTGSvRs~)BCU1ZC*hAq0 z6%7XUQl|N~L9kdmyM|)edS&S&WvjjMlDQb)KwZstxnOQpXcH(9+1HOR9&S(|eoHV= zcK-I*Etd}6aZQ-p=As|l$#L(ySiNb05dV5*B$bq+#avAZdTe%8Pr!lcbpW~*LYaoJ zu+Mjh$#r#)MO#TqkqLZ4^l7@nG=xONx7YVR=cm|*rWn`3&vkx`9`nSt;oyH03;EZ? zLfGx=_}@ZgELXjq*LUkZDYry0m&YhTICl^huY&_oeQV>mE6jRU^tUZQ@;uoh&HB6| z_HbL|Q{{zLpF1ia$mdOP4!(c(!DHg10TgUa9AAK!bxDnV2eRs+sZZzwwtz;D{7pZ^ zIoDawD?WX$IBKKzcZkk|+qPFyJA=;lJ6&>SlSEi#ufJwXETsrKh(CP#&ZJbx;iVn$bjZir`tFtxi@ghViJ%zVJyOulN)|qGSc#LjBL~ z=P!=l{}WJk)Tx3$qT(O43dH#YwxpA)*0bHxTcZ0hwHAfe_eiOFBk%Skuta5dMR$d2 zIbC2KEY6)+^y9(YlajV>|L=!TJi0cIve&#i<>08HuH{4_B|(3Bt&~?grcU&uA;!CW zvL<|fJ1Ha_o9(KwLEMftwxz8TTwZ3%&O3LzNpAk{M|{!&(w*9%L?C5DLeE$^+MF=? zd~sIMt2)Q)vL6dbz;?2;9AtEAkA0YOp)(=9R$=UuclYRD^-E`4CGEaeaRVpg>_s(CIgN0XUGYDC4hhevqf$2>wO&_J_;=%bZ_- z9SYd>@Am?o7LeEd<5Pb52hlg^U^hI+`$s9&-yh|Vd!2M-0=>;2^0fc;tte?h>L;lX z*@hyH_rIqcJWpKyS}>LL|78t_D8<+71Cam!FT~%(Eq{Ca|5i)`QeKCX9ld%Vc>E^A zrOmfDcO)J@4L#gNTDd+F<{XZnA)z!H$Mv+W)6vEWTbclQsZRd^@yY zUpu%_T69`V$feCG6UPvjtr(-OoTtc)avMJ$1o2lh{(RuPeZNA<{h7G?+Um^s&e9Vh z|6L3Jw=XREn}6grJ-P2Y4|u1Zn6;I5>mK!z9OY$(yMO~Yv7FA3{|-KXxZW7`8cQ3! z%vO9P(75Nqzp$W>3qvy);M55DuO|*vWPq=+BM0)9!;KN8`JU)@D862U`*UnEL5gc~ z0EFK?aXks!=Wb9hC1G+-&AYVnuriUbL7H;wb>;QZj8v?7=Z#@5=Tu!@f#f}VRy4;~ zmBC3p|K0we#a&zDS{f$c{le29@rj&%a*@2^9!M8q6>4yc>m%lwe$D6TO96By7qvH? zG8A8YIdx$7gn^cu8Q=R~1$&7_Qr#0YPeJ-8^~ldJEm}taCeIT&Z50$|6#Pye&X_@O zq|3d%OOvYRjbn;5*Wel@d3yy9hK6!NBRG5e`T=4~_x_Kq{EKD#(tPds0nrdZlE9)D z8{Hn#Rb8Y(W836jVcy05mYAnh?n_w#8J$vEEO7q`ol#VBz@JfrOw<1u%R0l>5Ab3F zRdT?yQ`<~e?K^&Xb)$joYze2{?JDhS2r=v6QNw4TLV$J0^{fbHN`t~9A^4y%3BU88 ze&ES7wuUXR=Fvi4*h9u%N<4P+v3de-@3g5E;^jfT5hK7kPIm6DT>u3$?9{lWYKS;C{S*ujCv@!PqMl;Bx1UoCbYj{Ro0bk*Mk2^N`Su< zbi9h4(3dl+ZFX7>2NzRv^Leclv&m7}wH|~+())X_6{TP{_B$5Z#%aUqS6k9p=T>C; zhxl?&P5`0NY1ewmaI!O3d9n(+LnQ#6ue;mFgU`(^!E+%!W}Od(Y+=$-Gyr0{mV^D) zaiDJxsDgTz&0NyyM~{iQK(QFraZ?P9+|NTiFZij6OlLssWEnv?7=E$~O%Ulr3@*g! zyHh41FpFefjI@CeWuMT6TrQmo;Z24($oHtxj~Ojck?Ym`I6HSy?LsVs>f>ts9>VUj z!TI@I3uXu5{O=nB7p?tg7A9q|v(e+}b5_8rVh8fri86zjT4?{;1|fgaHOM5Ej#Ex| zke{K}G~nJ1V>O)|q;wrx4ZI~6mD%2;p>xxx0Dumf^&r}6b@{Q_kuYvEEem*fxX#Yp z;3sermP|G@RA9O2obF0QDQiPTwM{4b_Xif6JRG}nLI`pk$1I0Gsz3%DcN5bP0 zd2nB5UF+t%gT;{HW+|oX*cj3}&w#229Jo31*f+%f8v8b2BbSq zAmVUiuEXN|LfGi^@tNZya)D++Mf0UyYa(5iR9Niol?VOzx{#fPttP~-!8)c2D5-`G zlR@>gH!YcT;JM3knM&T)Ij@6$Y@bf;lm{YnpzGxggz4FE4($_%iAr6_{A1P)uj36W zLiSr1Btl($p5!LmNn`9E{6wx=awVdv%Vt)Yt!k|2=eAdM(uq^O^`HUmaske)mdRe4 zxy~{QtE68%#2GPEm4* zzc5{n+`Za~C4|;EoXveu^tz^UmWvW?mwq7FBPY+pcQJXO;^Yt{*5F>@RAckWY^7cO z3g0>HdbMP_o?_A3hYeTj;5a~aAVSc8mdO5e zBxoVmo6(KA37OA#s#d8`t-z$LrN!e%u^19$cu%&HHq5#mLoZ%XQr6?3q;@N00s%ki z>B8%<(ZCYIBx3)nN`6{999UXs$>39EKK{gay1M6h1Ovs+w3A{e^J$EM-yG|8!uRAc z{%u-cAo@2u@~Xe2W_{ay6P1WXtH!#ZL_U&v2JUz*8mTr87K+GdlbTGpK){cqkXc)S z0M~>|?T&5NF}ZJKG7sVlt${)^Wg^sP;@GVPR4GU%5k)jNy3JTpoZY@x{u#Mh5zC51 z*tt{n;0>ip-aus4`Y>PelnW?KEPr}L#AO_|%N@b;YKNDSS>+%euVhXF;Hpo)9 zv4Cp{2$ZRb7pfLM()RzJiC%j#fE<#>+4(~~C^WhcnUM2SmKaI1YsrHO$bc=J2ad;>#)m?wI~?~0iSQzn6>xn$B| z=YntQs)v<3JF7>h#+sSSYT|fH0+K?}v6PZknWZn})meM6GM#(NioFFAYeoD&AW1ENeKV{x918p}R@k14@Qe}!-ZZ#?}F^BzJw@h>#c5jKu?Rv_L%}n;C+=NnOZ7v!cke#vjc+2iD+sz{~VS5x$`3+ zYxEd;@eQagjxZ65=aN1(U*37asZdfCysF%Rr7#R2~T z=rEK9@%pCO>ja8mb;2_WIQ)3yz&BPYD1u};>eQ(7#hGQd30%AmWI@U`x*h}kM~RPp zQ$h)C&Xdo=QyZn187>+5Fgeu-&HCTl8i@KGYk3tYmn1>FQm1Ncim)^|EyicDNi%xV z)FUNM#;%cImD)52^ml+5)ydv zg9MxW>w7Fjhm(i{rMvBzsUN+U3x8`fg25k0_!D8Mnl{pB^WKu4X~17{RbIXGUlJ27<6uOJa4wdKQo2u3o!K$ zvIfD49VKs4{Vs!%dBV{Y5`^mfh#2A-?KJ8GbS~o4)i%a$z`>AEzYe+Q;%d{%s$cc2 z!F9(Zct^9!y#TV7_CY_rvQla;qy*~68b-%y0nFZn>Vz5z^b5&&; zo7FQ;i<_Z#!(KK-YsCi@$1*|cL!=t)8PSTgx&VX_V%9BxS)%x%M+pZ%8Gy8;MZ?sfs)7r*`Ym#T%&`qkSX@LSixSf33-U8e^{p8`?McF*CEafe*# zY`qORP|>{bC)m!u5vecKFmnmYeJNjK5Y!y>6ReU6IYhRpW)E)Q>_P^1wx$mdtLeVc z(_BR}u5I5GvZKzF=ypE@*7#t}RRaAC$Hg1y?PInj+H1Db!p$#cr^tLEpoXaJcO{X~ zrVuF7=IxlNwUg;uY~OCi+LCN_!X@o~63ls)t*B=))expfGP>z>{3G8hV?Zl$I0rUB z<@dguY29>(2g;x9*&;xhM_oo2N7EDUB`%VNU7GkiR{jLes@L)b?~_BrI{$VSzHNMo z=DM9bITj(`z{e5jnf^y_KE6G;opPoLJ@Jl1ya;I3vZYmNBHAj<%~S;fWzhOvBSpfq ztI)|6F_TqA&Sf|UVwCt6#OVUuH;kIM4!4MxCheehvxGMl@V-iE&xiC)Cy) z@sbk_^iQsPKic^c=&&3)t%j60#;!O&Jx^I+a+Z#BA?CiN+3G#T&T;RxL0kY0?fYm> z3+0&(!uf~cgcznv@ysjjjaP;yDWuglBiiG|+VsrwlE@{uGGjnx)kbJyG`)&hUgIi! zsuGg@Lb$aM(_c-`UDf?lB^5b`qVz*Y6OP$$J3_*qZ(|>+t16O+(AMw6qK1sWP5I7? z1z)owr|2{mcGr5i8TvD48-aQ6pskz%(_R{_jkN@`I2W0 zy)j@tj1#?)f;KbN2}E309^+?8XA8kLH5Ean>5nZOUs8mtI}fe)!W+D|d%Qe4u(v^w zMdON=L|D1vt}awWA%$pgfpu()ylFg-Sp9S*vUEW*=rp|Gz?mN-q@(WfLY!XPLXxqY z7vE-fX87q}a;pCmSbz7pb4^&sEYNg1j5W#kr;e2Iw@IBH^pr19l{^{PnKQYpg}y2K z6ximnInL}M($iQo1$0>jc0pJ}1%Mu{cyU?ldit((#n`Om>myPUujLMVP4xH9sADuli5QdCVwFFm&?bi%(#8DWDN9!b#73uQBaU(VqNuFdEIy$+ z&Pq93n(&3!{r}+We+5zY1b-sQpy?2760qE(`ReWZh&(J}nV8(ZttNGzK?YPp_7-Li z$Q3;KoP~C#H-<4!x88dSx`$b9H6EGnH%(&)>82im^kP_7iYB}sr;z$x~A`U8-Bn^W~BZ!X`6ed~VLm03d;yp3XaMro*p( zT%*htj(tSwV@AhYQ_N7CNeX`Xu0)Q!K0iqBGfv3Xo)qOB*kDF*1>~qmK65~$%6w=x zVXchxbGC!$;T8?~%2AQ3)6zFAfs4png-v-pP|qG!t^(%v-a-EV1>_4V{Y(WoKq^2R zN)FPh@Nx|i`_59b5C>kj7EvjWaS-Btu`97Akn5ghBmBcLBEKM=!mM0O4De1X8PNxjY@_7@_ zZOcfBz`KBJj)kA>$RKWEH$g#DHrV9(5_fuaOj5OF zj}KnTby$)j;-*N%10*IyT*ty{0%dUyEh(H`>IZ`;tj)2acboU$QAj&QQL zNHoW_kCl*~hdftj9ne9E20`AD&w;2Wz)@DX_F0~7j?xe0w#&uG`XWS5suIQiyTzg? z{;5v*yoU?ph3H?#GwF}EX!>+DjgDpD8v%XhN`_x+3p-?7-eX9WXR^w)NNyE+O%uQZ zw{~YxY^IYEdaA8v&U}5~ofDN1nG^zp*gmKo+$~V5mrpD_SdGy>$VUd~yS19f?c6cv zY@X?NitG$BD7FU!-7N#q-}-!2J2fDU4JMO`qkP5h%Q7#qSgcw7)OjuJgW|QL@B^!5?gx=3 z!%`|{AFwPVn==KmO!PsZF1zamG9*Fla=yUWORMH9vZ!+IU95m&omzG6T631Dhf?us zEA`%dhT?v3A|BV!P*S1p(lQW^-(%M9#ZF#w_KeO@BU|OzP_3a?J2zgRt4((zia_{) zZa3^EgA^c@5^jvRCal9rT7rc=w{Cu<{2x)kl|P6A2+j}4V1pPKq%*a6koN(fC4yx> zi@z4caFR#MYDG5&jTwF@4`n<;0t%Q5#VYOBic}q;ae^MgRR@)jzUUi>i<&F5&*Gr3 zMws4ZKC7t+3ymL%FcZj2m0FUxg$8%7BqJq?hz{4r$JCWIt&vzkAr{WzERxOxpk2}^ z(~lEBI{*dASJJO#7{TQb?BwK-e?y;a z7;N|U4pq?heW2wma}sn|d=>jhdvYgFCn61~DqerWCS9wzHvSIw0VMF_owyA(#u){d z2Z=2{o;|5EwWgz!4$%T`WY;Uv0$)wfQ4h1MxjIa&G|ePbmJ|sD*>fzYW`WN{sP7HF z7`^I+G}~R>a9yMFBb8rr_!k5g@QA2N3+NRFAYXmbaI7{XnLSf$dry8Zk|ZBbb@|nl z|H26U0WQBH1a+>ZI!A)2e9pW9EU5zBK)1cEwu*R^j!Dkfo&G6DjzFP0+{m%7X_i&1 zu1za>4@D zQ_uAHR*w@dp)d+5e{T;-1#-7jG&<^xQmY9+NYI3P7nIM+xT#?N@i$ew!I$k#cB^tp zoEA3eA8wKQo*E`!3wCTrD%}ju>f{Lpb`g?+4}jk-m-umy@wxIj&Z*m@P&z&-p{Ft5 z08gK*P{Zsu+KV#mjPpb377d~}{dihQE~|FHKKP*Jw)`>1rc(hLlp5=snR(jg$A z(v1QFLwAP?3`i;^f}qmUozfDDfHacQ-Ep3A@BRJ$`@h}a_g`nNv(7r}e6Cq8(1Cg1 z_j#T>uKT{PYxte9?&0P%kMsPecu>Vu27No0J6{%Cs4qXkK=Hxk&;sVV{d$;BF5h-m zCE_7Y0qLhBgG#0O@XT>_{X!$&;*`02lkt0Acz~yo`m)0lmOnb4# zH*wWk8Z#hsFhW`p(-6|D$!fFF<(_y&@1vh=pyTFf)P$zYrauAY;%t0TG)i_&$U!0t z&ktIBgA)v{Sd1bl1s_WGoyDblG}=}KYB8OEKu_Q>&=~hvU+}8&U+lR-C1zdTcXnzw z!Jw+A+SvjmE{c{T>%|**J{xDZgK0G=r6Xz|*mCBq zT#N&BfLSv`mXuASAi`^9A(Xj1UQdov$UGrOeT`z+b9=T?EmKInky5l>&ygLBqTtht zx0f}|qSHOBvNy|o%Fa6Y^{t)oKiYyQyEoS&ogaPu@RndsURYNoDTNQ<@(h~r81KOO z&X}iq&j2OKL-Yd$nT#6!z|6VQn7WeG;z$=X^(upjq~D zF6RLLQ*xeHlYCOelDEQP@TG*FC7U>p=C=1q*}ddEMy$mRN%BN(e^G#zPC*t|YQw;= z>|AYvbSgEr?PykZ0-r94uli|lz+iKbfZY=Q8O{DF&2je&mSoTy{j`yJWaa~c7WVA+ zlkwYwbNIJ?hrXlJkEBq17ri4O=YSlYJyAb9gZI_Dj;f$Kt9^>*2l;YG)l8+ItC7`S z>q+xg(|7lRvC>6Qy@;2(5;s3R5iPx9$0?c9Vs+U$dngf754i zUl)PzF5oz~@>4TX{^}h{=`wEniVau0gulSQGJiLf`Kl>_At()YQB|KQQKy!2`}@s+ zF$y+j5~#WS*_*S4r}Hmn7n3(&mu4SQCxv(i-FjXKrs7kbh805Q)_Fx_A^<^}5=ezC z!Jwe~o^9^93MlF?q~Xli3X-M&NPW!EaJo;xSKbw$mOWK^@+Rx)w1m%?ia@Pe=AQm% z32;iI3~w*z>ZFPA_LRgiEjAo|9CQEY?igG}hCv^XxU38Ae*`Hka{g4}aNc)lmG4BV z$1b9IXv3iDLhbRlOXlXHeXl~3s+jd-=ek0tJ+tZh!|6oJj>6Z!WIfjF%<*; zxoR&z`$aJUoj=mT-K?)|oW5g(zJC=8MIk!{rb?E1y0Y3tSME~1*U3w|ol7d0LA2-n zLAm;-g!EqL#)Q>*bt!!C-d?r$!84;`-ubV20Xna$Y&m{@$s;O>J_-(7s@k&YPk~ZX zRtIcl7`>H2FMO<3e3`fV5$C$6=IO){+UZfeE|>l>27cdNdQiN0agKqj(xwpY@ag$O z!Ti+Zxl+r6akmWhkX_lvfA+xYltPg`uvs<+Hr8KrqrVh5GfkwyY>F(qVp|?8o-_go zSm%*t==tS@BZP=R>0JaN+naBSX}D;$LtxviR2*zfsghHw5)7^+2pM^kb^K%iKz7AO zgrBo4DK+Z%@t5uv?CH+>X<;La-*F0j|{qHecof05<`% zpxw8_qjjvKQ^>OM@CPj;_p9@G+r*cLtkMTLI=p0hC+^dRLp^ME>U{E2GePRq1wUts zi`mrP`rYo*{&|3ELCJSilf2yd{l@Q6i4QuCr8-D$CQ#;{MjY)| zXKHQv*;*lhEjm4-;^z`P&PGY){PsaPL!92*Lpag!GIp-5F*Y-L9$6d~y_oztP(jXP z;Pv73cp~zDrE&UQ++cPe2>~yKRe-D5 z6DlM756h-z0d;kkZb?XQLOykp7VPGum3%) z{J-0tgY3z>{THRoe>BGY-6!=IRgixy$=?g{S0?G#bNah;@Za;m|7bq@hdcOxuZ8oR z-sh;8OcxU2d@TGL^Gf%jZGO6Q1FBebMRX#CDYyMdZ^;gIJ&v7S6@U3dYHmR^m3yuy z=?k;RV0yyet6bk@Wmv#|3{?zF`ThS(2mV3aF8wkvmg!v> zEsFV{slxq3YS#)?Hs&=s96eI`e}4XtU-a)^B;a7ff**E~FtGj?P1yet@BRB?QBePW zvJ8K3gMV&=43(~(xi)v&n!i3}=LOB(@pe*YikG8jc(7po|C943(hg2>h(vYSiEoqI zZosu`1j5SlGWXWjS~gF8wgeMn=Z`Wfn*N&v_5bK~+{Z-GUx-wc`9Jy0zZVx+$G^|` z-`n8tZGa3&{xRA8X=^YWiL<|qY792>|B_PuPbL)f2)EC=>=ER+ zRSOSB&UdQ*M@lvuiEY_D_UL|UqUL|P&XsLx9~ z01;St8Qn}wUZZE`j^FfuP2U3a7%ZX_6BFkGJF5H^{4Uo?=+{js;GyxcOwwwxVdkwc~62w-8WG?{x&VMZpkS%;orzXIR-#@+P zIMS7w`K$Ajz3uU)&KZ+DY8PzS4;_!k(9Y9SZ=bV6hqO;sUURKs?tp4?j%j z6T`tuXhJMMTG(+Ma43Xp4mNmfP6Iw)U!UCtKQxhJhs9$+Z)8zr#-JO{mzz8_70EQA{_ku{I=vI zmOOWUd?I#RZ}=Mhmdx{X|0h@re^c3*w?3Y<#3-m_WR%4nLwJ+^i-niWMJ5k7z(g3C z7+Hkse*-kml}s%xERMm0`9LeNv;tKOcyO3v@u0YChxgjGYgbo|2BbCrqElN>$4I-O zOVeSZq9Xm}wM^}eSj@LHKgqQco+R9qA(oL%z?4zBTPvqcEJOWPE*6vIuJ*Fnz?|6p zTbHa{&c|8($na7W(l?x zDpVs1YKnyO=vL~TCyC2*#hA@dXm>R?w zUDN>QIB~ucv9=CW0W~=F3T!DJ)WF{wHu^rO0_q6H=}mT{Hy@OmhY5}7zSq73U+l3; z?(9cMU9zu@7AH$x9?Jotb}Np%uLB{OicnrGO0=R!0~r#lOI~{5B3V!NmXn#4U!ZgN z9j-rkQ1v9ev6L@d#Q6tyRAlP#!IR55tQ!A|+9H!2B@*RSp+ZH!1hn|2&#ArR6?O+T zk3r=T^lPodDUW~vw<*0`V5ps_=l1KO=Rz%Fni=Af7?SQ*o3Yn$Vx^fG0&Tc1salpm z1&~Mh$t3nJehfOh=hMGfmhE9Oa515v_^LVaD4GG)JhFsbJ`_DemXHEU>5-v_pk2~V z<}qM(Y&^+@C9tZ$^7Q=Kj1$Qy>bk<rW`A#c)0dT92ekX1#cbL%gzc|qM;73k1XW&HzJ^i))Z=vi- zAhx`*uSdr+8P&SRQQ;M*Bmd)1UKuK=p2{=WFjKT}{pZ`W-x-<5uEVRbsn8H!I!BLi z3(ard=-|R8GHsR(jv(}`Zw5Y}0BO;lW-zr410Ei z>y^1TUYz34n>!ozz?Q01J(=3)Z-)|#HcN+xme6lg&uMt#Q9omgN99-uw0S0IH{uzp z*bM~n04GkTD;qGuNq`A)tTWU9^gSVlg@98uaUBCxTnz|5e&ztvX<)1?eL}LM9}GZO zG-I4qlZU#?!0}*ri@f%hPSZ}L-`$8*k7c+W)Jf>M#fQ`J2|SjyHgcYaU6CYAeH=b` zOJE*aWJ$l%vE^#HUr%A19t9V6Y0)C_r`r#O)N>r?ZWqZIRc>sXW(E=0LZAqm zIad7a1@z9d>kmT%w;@Vk;{1?UD&^x?s~ncNCc_Qx`*#6teDM)z{JCjV=l<>N?k#8n z);IwNhISW99Im*L2w6KpTR1^k*{t(?7=>{OfR{@fuov#y8gs3v5|NB{a<(5mBOD*NFV$JFc+{d z4`hx?EOo`nJ?C}0hPbh9ILFf>has-ZAaOM5V&3|qd7?dmL&w$s!@c(lV4b|BauA(7 z3zQPx<*uv4-H;B@awlGIjGRt2_WsFob`CMpCO$Odq@>LTWktt5E(B%vQf1c^U z<7+r(+Oz5N!1=#mkUe>F9syf`UvxaQL!)LxE}~`JouPnKVAP|l;hsJ zSkS}WZ|CP>?Rf(pcq1j06^MqaMkvbIvjm94(Pe+JX}s4fe6;~SU;;-RRK(@Q*_w{l8~Hd8V5NK@x*_7Nn0|5_nF$H%Mwa?h3j>pwA=wwt`(iwt~-6V2D&t* zE|`Ip8My1p7EV`Vo zax-xIF*(=qqdIcdWY4uLR>Cea-!e7DZvEqQ+@hT>?@ivUu3kY27@= zIO?{EfI7by1aodK+xGlst>`viTQ;SXp%E?&HvMTsF2aw8*~Pf=`$M>n1^(~fBiK=Z zZQ;?EoTog)(i9+jiv!u!L_>w`kSwcaMganZj=b-HY`gfGxI1w$k~|o`ISETQ$&$r* zDHYH-ohj*8Tff&Y=1oukN8sA%K3?U>3xcMhyt(i5z>WgZJA1?rGnNHgFa;1rC#HwM zfT)5V=C_ za@p82e=QsHFJid$sXBe1De0615ao{ZECb_E`DBU{Fie!}A$i1s3P&txUR|sAnDNt} z{nkPilkGUuC}2CtP}kp+$n_Rjw^K^92Vivk<_ZPQ893qbfQiYNetsS>=mFsY;vhaI z$LV^}nGL{>5k;k4X02Y=U+=Y-1I+#|c;{+8+s`;O;Uli%dPX4kFyzOCkKdXs?PUH1 zcv?$fVICd}cy5~-gpy)I6+r;BFxwJRn-5&};|!5Neo`}s*k%lf@~qY;SY}Em@Tk3u zy~%DhAgt@kFK+yBbRvT^mT_^&1L-{C_4zLjWa6&_>4iLyKgr?857cSSf!dy#*5rG; z(INq$6)gthj>%f_))GMPLGWeq13q7+07XSmk~9)hb6AnZv5$w)VFj1`K2 zD4@QXs|Uo`6-NY~x2xd{3mq_-c9WMI3>L?NOfj*?CbM9)G;C!5v=BIX#u;ehWA@a{b9LYb2X za^mPeC@4|M&8b=_e){O6Y(dnK%{%TBaQSEa-{HP3-s31lmK=jBC1PfPfyAM*>~$Y z#EbPrEpHJj10vEglt~gkhuE?R2AR8e-`#}*>GbCboVuJ!7eHEQ zO_cSvDv%p`YdiD?Y1im_a)5ekZ37$60w3B`wOPpi)d~|`QAem(3(QkUhCKxwFFPWp zTwjJzT3b9b1MmG6D7H}udNDPKfk%H(c#b0#k;p$u%fms=XoN`*aFlNlaZG$l2JpFM zdo{lzpg81~jdNS_n)-{ajXVND>2A0%)ZV=~gEQbB7J*X?j%92V_c~q$eTQcce_jXK zIOuV$L5f1_Yl+dz#sH(B0^pI2`t8cS3CE`HXc}R3s5voY$vH3J@(c$f11*Pi(w=J*M}-L3eHCon*r0ma-h55SI!FjRZ7$)_v@Ag|Gwq_Kdy36 z-kmOFk_mHNi3Oft5#Ys4FqfqS`|lr>3+|VS49o>KgYhma0BOO2ARsW5F-Rw}yU@)9 zXsWbDD2>MOv!sJi-8+GwOahX?QpY9u6 z<^adth0Ill0BG6`;FXQXW)e1s(*MlB{sZqL3H)Vgn30wyz7QF4{d%#Zk{EUI+l_Fa z0HUhJ<{&gUh|m$RXn^xs_N8dO5_Y@^oK@pYhb%(Db9)dSBwv6u7C*K@G8DyD#BQX( z`^mKb*+!l*?JVZc>vH(ix0OWQ*H>HMR~BE3EoTV-1jUh()_j(VyPB0rVSfnu5#2%>O; zyV&ue1tvcp><3j40-YC;4dE%=gGR)QwQC~-WWW=PhYrz{6ZP0k154O3uMI>ixk0&O zugk{}tD0!qdyS{=1jJ)L2eIZ9*otBx!rb=gpB@JTB+s4Ch> znwf7W6K(cnxG(*9=uH@)efxoPaK2C*WRn1Xsy7UeBG~m6P`})OE`lH){-YhICH1)f z-g|A96M*NXJSk1DO@wTOQ!` zIokY|919#W-A5c~P=-8myomhv%QK*oO)UU$O17Z`rlUD>ID@^)FmY=xxBj#Oa#~S; zrcoSzEM@~zmN+B?Tw;Jkm-02q8UJO`|82E{^8VpVb^mjRt9R`T0D5gCggIJdba>7J zj%tnwvMvx|?fvs@GU~T-lMNtuZgNWl zczi;M>s)%=O{-yU(5l#Za1RO6F;mI0Xrpvr(qyEQ0N=+&Iskx$vSOJE^zqKve)nLo zRgr;WlH`BxeOAC%|2V<*=a)|zb*LD)w)!W0gC{EBD#<-V0#lf{$?C~}RT}0V0Z?=q z)3IqFT}&UDJa8Yh*h@7I^!rO3b?MhhL9 z24u$dpyE+WiTv(|*YCW2P+s~k(`5Fa3#Z%_yf+_BM#O5t8XXz{f%7{8ZkG=Rp$l)Q9&|slEzH^?( zm9OLEp9sDi*|!h6Um*l)KHHYF`}c!<%dggon{cQ56}w&lRzhUK!gUP8Wt6ZyuQdw-rEb|bp~R#u z`%gE3bzlKyk5@D?S{{2#pI?BY1#P(K+&Cys7Ou(6?(}dKuUzQlX*`N6yj{G2@*)FF`4)QgkCfDn^a>suk5(Zn2eGbS8nEUlquWmFwesI{d1qRDqQ1?P&4?`fbz@_c;#q z(I&Swy`W@BXlRSK5YDum-a9_X3R;HHHaADsNR6-~4UO=V;Un%0Ly%3)^F8;i&5FGe2#mNEtM$3VL?upr!|cmYr-vYUD@9fxJR*EZ2X4m) zr`|H854FyH0*0+EK>;fF!{PAUhR*`nI)@h#2O%||TnLXoR)sDzj64E780E|C1**)E z-?q6uK@kOGO;}_utIGYQ;_rdLAY_ss_;k8@C;0~XRgp>4BYMSiQ$ss!wo?5G;dg?R{^Z8_~-iPEW84!SnPfqf^~_$-&F zFXR-F7iM?MYs}n;s~B2~ccZdXyTb#q#~xB4Xw`H5h>zRKzN$C)y%@-{`j@?R%sEt_ z>WO~cIk zGV(s2t?hG)2=NSh%!i0^Fc`{x;GVT5i}8?T+29*Z3hFtYm%Jm|mY?~(k zi{OoHfUflChD>b@Wk)C)OtA&sIc?gnKQ!frv)-IsRmag$-315&!dD zq1mD5@rk>Y<}D=-J#|%l$8zUC)HE7{uES@gw5H{;Hu*VtF=XV)JCqO~Q%n{eTIXLS zB;zi#cuslj?XxTd%8bKu0fIXGgh&>v3j2;%_jZaLHV;FFGwX8NZQH?SZDXkTX|rG0 zf-!x6jZ+McMYG5hZJHGyVWdV{cQX4mD)13EKFfNuFzS?2nj}i0kZ_UhTXDRKc>@D`%97Uf>oo|OIo;4DF&?{Wk z+S0lza;900?n13MoKx+(sjbh`5 z0+0|q;6#tnEjE^@yE(oBK&P@=A?DOdG>(P4W)|ExG!%{q5D;W|m*EqY58!f$MR4<{ zmuU*#ZTOgup4;sAOI{0tz|qFJ`0R;Ay)YDOq;3K&9QS+HM4R8w>%1*GSi=`e)r!qy zP9QT(*SlDYUu}c2S)UUtzZ+B_ZzrjCjGbIV+h{nN_VM0i*oJ#QX%_ADx{=YT4SmS% zxx6x%6%uhD7h;>%eNup;V*`I?&)_aFEqu?GQ8jFH(Bjjrj+{YB-n+aa&y^=8<)!AHxdiWjql zlXiIk0wdqlbiBGZ#(>D(J}S~VN9#{fy-}%f>vA@PNW7@m1Z>Uwo*jB0?sXRxx4!cf z5770bl^{R&Lv~iw(T?zM@{7~&&}P1=uWFunY8G-f%%SJpAN|0C{dq;iRv2g^FaRtz z2h~p?zlRW|?*ptUL^h`6zK8J{Ef8Ufkb(aQ-7)T!=vF&_?GTkcR&;uWn9+peulEL^ zKBwT_O(~Yjm_?MBeXqI-Mb#n2T-4)9H82u&!&eKj{}dt(h#@!J#GRTIA9Wi%a31IlA{ICZPm3?1Yxi2ERJX6Np?AP^avKLa1EEOkcE~9P1u{5~=hOq{cE2iq zh~d@oJds1-B_Ouu38jML`J0}HSEIcLdD-DHKp!>_sAs9#4cm@)t}cu=)5y{y_^&{5 zQKnyejL2WzSB9y_F&3%209G$g)0pDxRn5Hq5mY6=p+2Z-2AoOj7m$Aqwc}fbp zR`e}HqW0Uw5n^PU5_z#0KY02wmHPz&MbIV#z{JIhNrKq};(azmCY-nG%)9Y)fAvH@0+Qq>HH4>|ZdAQ3J&O*Q3xe1J`8aCemSxXwa9Gma>k#n} z&5e53v8OgO-C&=cR!57-yopKz(wC}N(I^B84=K0lStULIJ;Y6v@FfuEp9$jUjkP4l zwmoWgn5wN9b>C^YRvK!CLWIQ%BbdV`n$_5Jq6FmQhwP}%QD5y8Cn_Bz`p-nW61kEk zAfaJ9OP^YX!x&nlrfS02NaH8Ny(uHi67 z(JAFEYqeOo1_Js-gB@QJ&l-QsxYo7%NgK#Or?u0JnKfJx2i`+Sz=+Ic)q&?ycqrD`>^Q!?- z50;nDX!-8RRRhHh9>cqJg~BJ3l2ho6FJiN0LNF^yh&t*)WGX(qP#v8GYP^JB`aw}$ z{4|&XHQqE$s6)Q&&e$`vws0@M=aa*D%3UaqM!6F9a~(7KaBul{56W_l`W|6>;1S)$ z?o0EN9-Gt9AVO`#|F9_=HK zhVE>4;9_7AP+N{hP*B>ysV6c+W6=Uar1^qM7?xg5&bw3pl(Pu*FxIz?+QEL0#!JWA z())~xrg9sC5{Ed;{Q4C~RwL#5ms7z-kOa;)@>vAEYfA^|uT7>REU%L=PljGC{XJ+B zgd8xeU&9L3sRa^PW$&f~QkKJ9km1FQ?_RXx%yfO?Yn_4{E*oP2+gLuVPP1zVJ0Qzi z%`Z~-Tz#`5WEoGMW%^R)x&>){W6I^^yr5Ny-=u5|08l69r9~)Bx_^FW2Plp^e^qST zNqs4vbHwivtyUC(XaU?Gt9S6@tESODA^f)cy1BzNr_~ldTQ@(qeR>VUCXLKNC+9IV zohgpHE|X&HURPNtcxAnHEMy$|^V;_l3n+11D6MDR_ebj?T6<<+vT6`+rB*8@(C5-v%pvGD)qncMhJztbZ_CO2Uabs<8~8YR)^BcMGziPo&{sz^~DC; zg8~>(A~iC&a(Si@yw^qYA{Nah*d25iI=efI^}X&#KNn`5dISPT$I1DRFKI1yofhtL@ro z+!X?#39)Z88KP=U6(r^d-)%CzLa%v)<=}-Xg1A@ww83pHNruAmY|>@myH)zMUk2#i zuHJ!R)m!zF`xMOL#zj}{i-gf`Glni#y&MI_a37lB{t(-NgtkM_-zPf5vv9naY~owl zLiTSK@(;L}I0;lqK;4FWG;{Op=$4HuB})CA)WMZwg+KqPi^Dr#7JUsOik=n%@;OMQ z{YlHide69ufGf%3(#G_I3m&4Q=?Fr)dydyIqc0rB>wvgP1pvS80CnNW$G55lem+N- zYb|I}r`hUcd9)j|otuER{sG^Mt?`PzETf_M&m-|g$3IqVioNSRkU2>4YNv`v+7lPL zO&)Qz*;;*W6YCbSXJ6AR>bN@)cCz&@@g+^#4U58Cb&iF|&Ln%FVM%zN{&RayZUlft z_1=`tGN(ezn6 zwV7lGm6;q#M%}zW(3{Mo8~)*71Ykc?clJw#{Y8S@0)0@qOZ+d?@7Jx3`Z*Q? z-n}N}7{MQ!vare2YPOOL-piTSvqjIH@T(Ok2e5UDtPg|*144DZhC{3DK*y+Q;lr9Q zqHeo65n5|n6V?~aq|K)-Ww>jX0GuVya6V?bDbDJV5~a(@i$IHseaMANhEik%)VI|t>=VP z1;q|#)JNX>?cmO8#%Hk>0Q*V$O6(Zb0ovjAh~30-po&gr@b$2xD>~0*K8sK8pu#$W z$#NHWa|TrUH>_nJHszY$$A$4>igN)SM0-#R=$`lfTp{N)rp`h zzB13S882th=rc;>mI?^M@dOCZXT<8mS$ZV1f0`li%& z_NAz#1Z92FkuE|AcVQr(;6g@}0Ge$U;$52#TDR@yhnrF89~3X{*#r2j)S_-637E{r zgGGw$km0t9hKYTLwZ4~FZ}4r)$iTBm~*!|mF{qPiS` z!gO+P=FyGb?#HxnTq@raole7EwZ(C%>QF)b-Gd*HgS%C--vwk& zT`S2ZFYdjUtzkI&aqczq-H)<`Y=p3g;;NbM!W^QOQCw&+Y}J85qVir?W$c2IJPdcC zYDqlj2>q*26(RzeI7&w)0Dzt-WCl!9$Pr+oDqA>x8cAJ#J}aAFE!JK}2;tCvtFkz> zDKvVEi5ZI39tK#4KTaI~c+NX%^t}@aBlm*-$i9A}f0+4W$u0m3ORzc-XhfQ0p1+eN zqznXIo_0siODJyH^xq56OdATwuO?^*5P`@YMh&@|8X^0+Ppt(NLJpAg2J`+@U;CC8 z=Fk?tWm9JVt%jq0YQZ=9p1yp`ps5Zm;5lp=ZB9Wp9(fcBOUU6V&Zc-MAJ_eH{c?cNtw zz3QXhVvl~HQvsdWY0Y?{!i1YTdS&{UCN-`*Z;XTwA(=w)FHhUuvKyyhgsiNn*#0&xXFnMahQ#=miA8rj>1B%(<2Uc5~Q`%+jbTB{( z{F&HdAnsOPnwXDXf-rhbz*UAk0wSjnaPsy#_r0;~2UdacBZUuFgzn~AzSrJ`hvUDg zhjoqcNZA7XwKML$iDt6e%Ucs}&Kgfqk)o>~J%7Trf^oDuY|eZy!lM`3il+8Y`%>AG z`-`!_FK^JF>KqnRBWMjf3 zp+o)E>u2c@w}$mA~I&U5$&Y-sLFn${9!Ps-joq&{2xFv~uyZ-&^a#hy9OF z8y}74Ca#~K*rX$t2T=@RSBpu&x1+vL<#-m8#`D^~;FG-^&EgF2fPHqhlE) zUJO&VxxuBUrdMpdAzpZtSm&<=RbD^Wlsu7_n4egi2Z;Mqf&DeV5@eg{27F9wT50$e zG&8-*c8HO~pt8U(DqVm0h(6=35|}p{_C1inrl0tBWDk7$feYE4#6g+H3?cPr@5N1U zEIy^g{Q$j_Dh02PcJOsOoEi{BeP*D3wP8{A^|cJz$>D_Kff*>jee<}|Ml`MY>kTMb zRSSK(Lp3F6VHw(vYn3pH0jT1M-0x7mI%vou8jgr3D>9(^{+Yw)`PLm4+%KJ+3o%jD zf<2OX^3;coxO0qj-^wVJpC;N9`kftCoTRk&7(}qQgh;v$ID@+Fou~Tyumb&pi9uGD zaIJtQ`;vT)0sYg)(p$1)E#vLfceFDsEWzbKhmW_)rCfr)Toxc6uKJLz(cswmgUj}w z@$Ji$GFcrdv?E*`%#s5d+thvqQO6&h=42Z(K}`-Q3ec~^8{I+YEjMry<(l&^;!ezDSJ z0m+R`g@imBqsD|&AG)JNsqO~%ZQ(4^yb~SWnXMH49Dw;h-EF>}V+`8x@8G1nN@ftL z$U7$EJnG+W2-+gb0qrK;pq95$YmGIqh-_k$6G!kxY&Jz~Uzzy|vkyG0H3a2-bUU0! zpb1*L;<0W60x`9Er4Ev;Qp7(x(Ec;Lp9^c&vTAGJf~>yfzNoXgZRHsAVZCJ9ere9C zkFs;R;cVf%4Sf_%(?LY4vs@R+A2li?ukvHL8iOWVQ1opbFSBvN_jpHp7pMCp%ZY&7W<=D$vt96 z%PB&@kFgM3{dN(;*B08!ua%K| zKIC(-w0Ud?ukz)5$8tR5>YJXffq6tWtu*-?kV>-Vm<>?e}kW48vxRPlP>=viz6#(vC>U9iqK0we19p{)6>t zb>}8vE!y%;`&8~P#0`X$umuW|YRTpYl6T}sEgen_F7a%F2KUFs7{|uaRN`C-B%`v& zH*|7A59^@>vI}3#gvv`|guC7oK;2W4h*K4AQ_T@DbTB+aWmmq;C8o2%P){k&oN_r! z(E2hB!j+IUEV)>(nTRq{gmAa67C&W3y9f5^hQKy%kewh0GXfLQ%M|gGK7*t0zyc3J zx-E|~fO4E6gcC5pz}!RQSZ|iBcpokPe5X3_V{y}EtjW)S#xKyH}sxNRXGwBMB# zb?82WZILB^%l)c4FX38yTiY`!2&}p5XX2fw3F|_oA$P6si-kLT?sWz6GcLqZ(O0U} z2iqgi5hP$TtTZ8|n@K9?zz+AUOfqdRyB#n0Lqoc-V@9WlCcCByD+fuWA0dQ04QJ8c z^+Fck^elvBorfT-{4f}p5pc$_6STO0IZr5az$^iu^$PQm zs1B%RWoGI5Sd3>DC-lA~wjV$if&J$@q9gvWlY6U6p#faxZuS2W;s@)h?85k<;+GsZc4WLkB#Xk2V#< z6W;wgm1dA|v#P+7d76ce+nLfokW)0GNcD7nWd(*{VQ{Ha4w{Gtf|0UEu>??)f-Ni+g09sjz4?m@E%N3Hyo6_3QVN&S0w{H*ZADhv7 zTshgT*2?84aOtRwIzNA+mb&R++ne23+(^+EV7k(IVDEl0>u`!eK~~w;kP%HhXEySj zgevexRC16K7`|a3Z9b5toHM?%##bbyuN=*4+6z7ibl(}MaaT{Bt_-Jd6}+f+%dcWg z+D$R5TBF57XSFtNz)@7QaClfTd=NoI^Y|los4t(HYdAi{ayg=W4`4mj`o!Lt>yJkZ zAYb@ACDTZn%Sc?Xp|5t^v*c5kdCo~FGQOI*A%K~lXiHhTT>!w@e&6ag;o!PThY9cD z2nN*fMo_eSz!xLBW;VmIz!&a%pjRd6y>F}P#am+93<{pFj5NJwN(jQj-|El?^S`P0 zPMy$(;IBKk%;IF1l?5EQ*S@U}U)gzIRVUG3LvR75YEAF3-p`t55N<20qD1^`0+l28 zMk%pl8oVrHHNRzYs4#NO70MmuJt3j=GJ*syB1g-PQ6p&GM~Me@0E5D-P*1*j?3`FR zFZ}K5aGOj&J(}-{%fwuu)e5pa*d!%O$mbsZxrO>n0Y@t_kE>zC$-W31o;G`tMI+EFkHRz(i-K(b@o zEZ*<@w&cw~`)kgq77rIDTRIk??>uCd60Sw!nB$|$i5@6PWU&HZiID4BP_q4#`r?Jk z!_Dtx3-w}5<%?P~$*~roajn*o(yM``KKc=UKi`UIJU{n*t?%2ns+W68Z(4CrJu>f^Ezj@a=C^J+Z*3Q~`2>npFFX4xU#}=fBGl7iERJe?_uXo~;|=Xkn-fEK zVvV->_I_NK67TU2>cslGv|pTu@pI2i06@5uj*cc0xm(DcfY7 z{Epj*4!Dwd^E$tL{B-8-B9$+EK+t4jq(EL5JI+7t&!BPZ5s(BUTIED}DqNb(u{alVPS$-e}n%HH!6u%7fLG_F8qiTNYR(KdekQ@;ATc-)3LGX~cY-7K>8AD;8b(K^ZAH;`#+eKXjL};2W9Oqz4a7x+mc03d+3mEI)2`A=7z|KbAJ*vq;BZ#Ia>jkX!}=zod(*~+4IT-z+RKFMXI#Uu2kjm}G1Lb>2y z1Azb5g9sAxpl#4=iiDx;qh;%}2y%M5-kVSQ&|%@{bwoZRrrmViM%LO?q^Ue z?RIYDLdzG2GI^m9JmGierQS!uHZ5B_q_5ApVnx9(DU+aT{G*$MV)L85Uh9Zhv_%5p zJpCvlQI9WvN$h&7DCQAH`>^9S2GXBGrSaY2kO0tA!(|3f3f#o0Zp#k7U)t$5Tsa; z-c+P22m;aqhzdxT4gw+q(tB?r2qL{pm);4z1%ikI(t8gb0)*Z}2;493wfEiUoORBA zxexbYy=ctJO8NfppWm2sjycBG6;~BWYX6{z`5<2tCQH?L63qa*VV`<=6#c6WKWkkA zr&^2hbg6gaaJ`d7A(-8`H7)N#GqJraI=$>H-m9S3FivVi*(&l!!`p_FwZe%)yp9k? z@o9lCw9Ev%fTw8cwcSjh0eD=ZCvsnS(hpbc*1v2aTWjqWM5lAwbdj!wllK{ZI1o=m zwnu6QJ;1yvJJ+WhOs}`&p78pMvojO4UfyCQXKBD5PTra}chM*CC*0P#0KJRr0ok*k zQLQPkP${Kk&=y^Aeb9XBd#AzS3motM;(LN901veYvkgb|fp1q4C^(xd8HpE=(>>=| zgaYCwKbThPq&_2HHfM6yhK`6_7mbuqCdZ8k-buYrNa5f2ObZ!6w#ipSkn9jRM`VW0 z(7Wq1(zZZu|J7#7WBdKw{%2o{mRI{L{Zb#Z8Uo%pgXX|9a5WyC;ik5#;(=0!?yC<@ zxGCZd3WD$WHteFrLOlAP_>&o|Y{dxeE;938@?<$@e85@x1ORN`gu%jVBe%cvH5Y+h#B7j8td&c#T9UxN=q|fzb{x+3uX4D+*kQcE zF0&z-*$& z-LX%v8B%@DlOCZOuJI=thL#}j3lDqbYH}@kWsiFtTPAS>Y@}CueP2nnLM@}Q%(>z zE`J(CqaL#}o~dU;u-2`ca60_Rt3Y<)dAS9$H;T{28tr}}Z}YQp`TiGir5M7eX}VZ! zJyUOK;&5RQk=&i^&ba9G76|dc<>ku`{UAB9%IFzPl`Sfkz9ZH;M>C&r;QnBe+>K7x zFjRed5?0PxkTNrTl*0Svvwbf&$KBw)m|m~b;*19Cl`{5+pPs7rcF#t!Lq&rLOE@#` zy&`}MW)vXx0h@MshNB`T8o zIA=(j4_=E&5BWD4#(tB9x=pdZ7`vvz{gXkk&_?>gHQ=WSF;TPI)%Y@U)4QcEh2E}G3k!RHEe5SwVRX_*L z?}q)iyrDWHg7H%C6l=!sAwFkV=^<3;MJYFg`@xbQ8SHXh`sqV1ackzl-Fjx9JVt3w zwE`}`%RU)xGdb#Vr{{MbEj3;ddR+>d;`5OKp)*kr7(G`kr;QBULL!B$%vT!13CJQp$8xM< zC5k9Rj3&c%hpV_X92z7`49@o?XFBp`U`hu0Div{US|7l0JQ({Qec)E8f`|Cg-rE#$ z9on>6Q3uUch)tJbC=$2Hz)zzX4gzfCU-Qp`-*&I5>%_e6&?tJP4Pn^-s<4P|AzK0s zCbmM&l8Cn*wKeV=eje@H|*}3W4Xa%?b?itS5(17!ORP-Au7`kH)S6z zQNKytC7rYW5mge6DtetG1_4 z<;k6CGP-uX>o2I3~f>?hGK8K)F4cugYuE6<==o>rDz4 zIC{z@Rc|Ce6FrpT*ivZsy*z7-H!T1Bj^=^arHNP{D9spQpXN;jt3wTZ^u`Zg5Ca(7VaawkB`vg?oS z7TeOCkGUuZg3^4ZnOh)OHPZE&++g8n24~w+*`Ov9L}Yds=fwrgTn9EDH#Tt@)amFG z{hVB2B%@=R=}KhZ8J?SJUQIVmg45pX;6E~skwW0&opU{zw$HG!fYa|?6kos5cEN`TEo(23%{gn z6*h2#RHXWw(N$3~iL0}n3fR*0w2ntCIxmCO0}nrC{veSFw`jCHUuAWxF}s0itEA>* z(JYz52~b4%)8!d7yfdsjY-4Ixi|o=pH7$n&Teq+hCVf zmDMENuVHV~Pg(qI8wM1WV%X6EQ}qWmLj|fpl4vcn&Guy9EI%t%QwG>G6UQR2n~r_y zBV@%vLhAZliyDTPP|5b&!d`Qygp|0oq#XPv`PWRqe_@nwH<)n%&Gz6+{3pcdiMZFjv{lee1y*&>onqEPef}oZ=$)Z5ba#1A8o|dIV=Y zw_K3mi;i}cG+5z88==xdh$emHM>+(|i%m|wJ+i@eYqIf#Gq`T#Copum$^{P`wEurtIl_A5I{<#G&rw z)k0>Zy@z#&KH>QUXIlR7$z;=I@2*j+yz>msjJBIr@Wr2Qa1gQh+N~ftO70g+pD8LI z-+gSuwdoF61HRkBBx}Qw2BdW4U5I((&JB+lxK`ByL--!uQA-%OF$~*M#s2RJ_K0uM zzjY6Sz>x37UfkSrM~u4^@YlXePSb@xgpr$zJ|@A_$lhH7QfY&~4TdwWMySLzJI#H- z-^CtTWGf_9<9c|`x;&o+t#;$+ggj-MB*O()BS8<+$@7YkZHXK*tla!3(fR~C=;mD) zw0p;o;1%3S-Otd2J(LAdmCiX6Ab<$$++R=6SIbiHwK2t6h{ z`LXvalb(}SfxbW&pr`VRsmgM^W7&5B@QZ%whSIbbH=V~xepdhZnIiIj`u%WWu<;&` zmU)S2!%V7vxGqyKZKT(z2t+gcUR4ci~XrQ}$d>T^FrY;}d$c)SJd+U^`B-7%k^Nq)f-gZh zYV`aj6&uo9&;Upi=7zSVv)j0nDz@8gu50J3!g8hn32DA9m>Y1J`&;!@M=j? zVwFSt=zxMgWKl1tMSfo!PHz$;PcW^M5pDZu=QbnWYiBCOjnFrB!wpG)LVZ^rVS% zZ^!L~^S%}li}0^*xSRp`aKj#_8dUFul>mUGAlQfw)EZ;uUJP9#W0MKG&Kh@yclkws z#?SpSv}?=(ul*0(1koMI+Ao!>19EXi+AIavB{wvVx)TPQR&AfDHl;oocUa^>e5^$P zFXcz(d7FAw8WE+CZ`a?j5IzafOvGXie+B9Zqn!NgcZSh7JEVF*Yiq+PMo8`!_3kQ9 zQ_HdCRH?pjrA6*jf}^`-*X8Em(mp_r=Gv#Uh?40;2(KH5x7LfMyYA8oHIzk<{8DH3xkFN0II z?`%=_27YQ}>1HI;;}$9~VHD%;Jxy-A)?ZO`-EDXTiM|HG2|PiTeKY@iMd;s<0Pa8e zvP$BHkzeLS+_{umtdmEMpCn)orKv!64POi=y@wpGN2_2)LIye2wdA3b{MX3i~_I2?!Rr9z9_837c;TC}b+rq)~ zr7IUN(nZhSp9lH2%tpP_PwD_L=F+bZAWL!}^I_6>MU3ee^b1#8wZJ7ww(!LcxgUjY zd$MhcDR&LO6HF^9Pv5=s)OGCO;trm_GHxJ#^2L~+f0c6SYv$Flx{B*DS$ulv#uR>s zoDeEVmo?e5|l#8WN_5@O4H)v=^(qW9B3kE zf23)0Ao+4)LhMV{ppN4mVCi_#+t=0V<*Ch1HEv9LgbJBflbd#Zf#?xShrGY|Uh~(*eL*{>u2tj>o5o?)X`tx1|31m|fQExhFtbuDfcMz)gNG5CA?ya`k3H3bqVU*^V_OB}qm zeXm8%?KZxtUTlbwXn$yZ`V>JjeJ1X(?1IyJ6nmm_EOOaZx3=&S2hT`b(2cek^SSCN zFj~J@blu@w=J$%;R${wkz#n_#SMWX|`Ui(4iNCbcZRSTk34^&TfUL7NVQ_Uml%>+> zo0$LMJbO5mBJ&3*kkP5TkL*pM^cVCE{34MB5CcbgzY`0o96Oj{+Mmb*IP9u1kTexy zx#uwg<)5{tdcx?cEjgBsjBz3Lx#6$hlqPhix4;{aV{@dQqIHk#V)!gBzDa!BVWj-- z8GpEuyyc(>pa(ZN7(V!`g4Dl&-yc^*Lvc&DUi1)Jh zD=pVm8z=MO7%2juScXP-xeZ~bMhfD0se;VX5+bjS?vghX0)pbx(#~1iJ3`!DN|ivqLsxQ$A&Gi~iaLxqTh? z(*`W=(D0!5nrx07|H!gU&D+riSZZ#4K{S zK+Ojc*l*lgG(P9_g^u#dB{>iuU+-++{ZE%!{r6>d{C%0Pl~e(dUEOdYpnY@AdY$ec zidz!LxGLpw3T;@(f5@RPD&T_h^=#aFj??_}li%N#U?zya@Xvq#+aCM(?BglJ?~7l8 zyZB1g&;L2H@D(g;v+=)})&I+bNL)bhO|keN!|ylkZK?nLQ~u(y#NzK92bqYwBL6M{ z0p9Y}<^Qr_{^zIvmo4=7PyYKV|IZEf|A&qJ$1WXU9{@eY=e))pcS&gZNndwbe*W`r zzI_W9!$v&qD*wY~-(~}`!u6)RBnm`}m|s#zV4<#gxHSpt|CI6l1|e=M&RUWGd{bfE zo1R>?Km8AHIx7xdcxt+&Bn$pZUo@o#e_f(z{rTJn@}k;${I(I`N&<17k2~+i#Bd=* zGzIr1gpskD&;A)B{^xD^`{ZCm|-Mr>m0cwoHw) z2*=5fXMh%S3Dgl3uy@xh$Xe;|JP)zuvnCQ^cr!j#?<9A)HN$G^BhE?9YZ3wE9fW!)U#c zbsSYXj6v*n?~joD-dvf;@5w~Y9t*7`K;%fX&T}=YJ}&-%-#52rAIAmFZZOYMjBbT^ z?abrzGh&twizh*0BVMf4lJexd2gtrHrQEYw%>+d^o+qioPA?Vd#F@WT#Phw4018l( zqEl9TUw&VqS#fX@owj}O_zydGyYe?(f=`}Vn$2|@XvLo#{H|_9`<$cON)jZ3crIT( z)oKl;=foUs#Af^q?p)z+9Yc1L`jh(+kVP5G#jW%)++)=Jbm`=PkqKmdwk96yQf&Q& zrY>ke%-t@i@Oq%LzXB9m^vq_`Gl31V9FkGoS$?`mM|+Em7V_jp>;t2Cmrb<-WqrkS z=NBC6CAaYiNUD`WX@s8KQ=sB@S{sQDOM%JsG9Z>PRThhBm?I}@!Uqr<9_8>OFvv7; z;MY^WhfLcz8DrNjsNCP21Z%w19@#PgGbKYWeY+6uUbgTfl9XO#)xw^$l7_#C8+6j* zKqWX@)1aHvkHCw|LIXN5PdX^W!BR~Hvd>>p{Dr@wRt=P*V>#nE4O`jKdlURAX>4|H z$neMfgQ8imo!lq~kE8WSNk%e4-fGvK1-VJ*jckn#VFss-us>zDzFq;yvElR_$@TDG z5?lW>uKwd0QL#%@IxM9QKod1h6bzJefIj)Xz!)T9RuNDe12pF)pu80)20Lm83AUNi zO_!~y9iW`>E**?u*z12he7}7gP{2DZo;|N~L`TtqEb2^o<4%(oCTyTq_68zw&j>Us zbe?`VWOf94kGWau(~oC=zUho(T#TcUhMz)z{rIKoSS4{qh>0hNUZk2%`AsmW26XQA zibESf?9+^C3+vJ@Z(juc*5?Q2_MnF0#&4tVwwk>-0c(wH2|ReLfY%IWJb0{V6a zmpzA+HrZ{M$Uoi$BF#)i@3rv1Uv>SKr<`AYmF6@^TK&!Qk#ZnSdb?A;6a^HG^v;9((>h&ddMG~GG380_vMd4({Mw;HJzX4;K8h21 zn>_1>O4ppEaZA9#2ccujA2KOW+WFt&nGq7?I4CCh{XdrE&2g2UvHWbD@HC$I8n**H z;eLN+TSRK3M`zNo#Tfs&dO9S)lUK{6`%B5*6ob&~E_1D>)Wea;N7}q-%VQZ9(RSm} zK&mW{8Zu+VMAdcmpF}4nn>7sSau4(x*kU>2G}EQ5*)PaCQ$y@yq^WQ^uI-wtIWjx* zEO(`QlIsy*;rpmWUxm<$t9(?GEt!Oax_HBIUOJt)v)aeFUuTWa;QW^NOySLI(e?Ti!vnkfa-k2hSq^0g_N}E2S(8+el4J&tF zBIcKbMkv|jK;~qYH>w@ znultjwq0uAXfPnzT9|a}R!7}hOOs6zt{l}Dob5MSUKe7xO{!`#F$8@(mMf*U5|_+t zG-4Tj|9N|)umVj2#G(3!X1d~3{tzw8BWc%@FHN?QZDv0HbYBQQDNHRKzWYS*kJ#D_ z7U7PTsOW$4)=;7VXX8bY6fn5fyoWMVHC~AzV1~q%XtA)X)soocOE%U|paOK;`*9u6 zyeIZq3i0~4xOCQw3wn|s8#Z`C?ER-_O5K7*ffhK&i%%^0yU5|`$L2!?_Zu<$2ih}k zx0Qk1KNDK}W0+m8o`}nf=vERZXXtsE3*&b5jf3+x6#oOvC($7L8lB*i)Ye${#}5%z|%_4fNeF8;gG`v3b+9x8moMVX|+OZIBp zm7@jnysKHvd0#E#$|b`1HFSp?_veYNhle#>+OA^M$JaN*d`?@iZ!lIZTgVijblqc- z89SV#fv(%ftw1{hdiy-xt+q@8`I{{7e1Rwllu_F*J2v>9L$$Rlnc~g` z7E{c(DDVlu&7q^XX;awny2JYDy3W5j9`il82%$lF7EI_2Ez;M`ndoegp=U(qDg|W+O~YGMA%FkR>WmDh}GY1>(H0(hQcG2 zN7N*epFE6+p{ql=56`TbI#oO*;_L|C#FjaF%Nh{-lwfPwG6)5hpP zYr|8Z8A*KRTBd88{?Rg)(<>}rg0#3x*QRl)r0#@!Gl$m3QOD*yHK{a=XhrD!J2B#I zw1U1_N&+F+sw>aHS8{(iI&Sj6*`oXEQ!qu`vFf?euF||0;YaGIsc%=8ir!^f zU07NroGwwT(K4@wq;dKwREV9{8jYDjl!$CmdBazf;_K1K^J?0iO_+6^@$-Z4Wn10^ zwV{I46hkU;0ioe|LSZ6vcWVYZ5Ig3v;gFN|`$CRorHO&`b}_mbY4LLPl6|3jctZ0O z?mHhTr)<3UEL;%$nt}bgRu#pQW=Oqx+2b(WEk=HYy#1QtHpOqd?Z5iNSMq@blk~*Z zdl8u*kT$)?p_l`++yHi)dh{*9g%G}5J?gjG%aEI}x~6Hz%%tXC7i_4H(?Y1A{@iIB z;}PdkphK^nbvwBrE;`(emcO2(>%6*EcLabuXHjjG$Xr%5F|s>61W%%R+F7J#K~V$* z93N=eM8Re@rGf3g-GxHvyDo>?rYBDHGl=t9sc~1#?*5=s-NC3H>uJ8zK>bo+sNmE$ zv9qyE>s8};r`+?CkaduP9s7DLgpMN23!!si5N9m`ct?C0MY|!Y`sZ>|9cBy0-7xJx6)?(cF=0loTotcd~qc%GQ?{NayKkn``@u&g2X49uW~3K6AD6(Fg$1!!`QBO_HWM(`@@rrWUAsFf2NjTE*kL>Cou7dwO=OJTxgzs@Qiu?~ z-o>61#8$=YFoVseG}sBZ59uI@$l0Zu4i53FGcz7rVlKr#&)ToR2_k^zrf3Llw3t2H z%2Q|(x_7S^#-5wlLGQTDyh*@Wv?A7e1+_b(Yf~q#XJ00A-mo{Nb2iM0VchQI(LWz1 zS)}qtiX)sSE$Ig)oiX%Nha#unL-(8cj;6dcM+)0jq{E2%#+uIshKE#5JH6NPbEkR* z5I?-u4agk!%bIq@J{P58TmKOZ;TJF2?;p%^|8HUC!llap!6Y?|no0Ze~1D36+U#a8uI{3wBKZ0dV#@Voqa=EHS$(RH%7W(Mv7g9Vb2?J2Ez zBz`dp6H5MYYx-=?);tl9_w>{LaD?kf&L#iVB@Ce0Ule8*UqXqZE9OJ4eFR7rAE-kBfF$i z$3dRZGq6$98I(q}yoR|LDX20fNbzTr9j4LNBjYAcC}@o}VWJ8H`|Ib>0XHBdm*TF0 z9w12PI`^ZP`js2vKCD>%##0ivU03da0LDmq_WKt9%RgQ#6O*?`3V2*ueAlAtOXGe& zP+vA=STDxbnRBHAFyrQ%X|bZ-6#Z$x3rB0 ze%-ThIqb9e=pNa}sdewLQM-}`g5AGyv@6GrVPG|JxS{yiu<%#g@s>`LW<%Rzw9@8~ z1CWiD0*3{BSIoQNaH0?%7|QJz)HuS@)E9Y2+!lKBIt=QyVPReV>t649*Uay4$pUV@ zm~T8Ze{~N2e$H2t4R;vIvqan}X3hVN#F*Z{r(}xod-MMy)c^iSVv7*ByP#JVWl*x_ ze=f%?Se>s_O#l70|3bZeBH+7Zbz6Yb#yyJWPb};T){E`(|GuF6VYtAsmnacdnVJ>w z=X>eDmmvLo;eSEX;PV@Cx5q@oy}y6b-&YCjlD{|JKkl!;@1=i)jK9Of?>PE*5dX(n z^>=vqJ3Ragr2LH@{)xr@4iA5ahku9I{~w|Us&~G0XpN)U!dZ* zRN1@Z_1%BbJC7L}PNX#-9>KHY1z6-A z>BC9;lRI{_XF%}VtLDA;7y zLAA?Kj;rkH@v~U8QTZw(eRz^iq!BdCIOWz$b$TZ9gHqZE${~S*TK^SAi!lPbSX}^ zWX@0bIVSX4H$LwE>e4{k%}mPeQC~k37Kl%=<%?on@|gU!y9mc@b`Bho2#>oi#cp-q z#dO2zJhz)kHfpxun3B-7ASK2hk>gwq+ut*-_Fjv#hEzA}J<9m(MOnQ0UO(2?Q;+ZK zoQLHSw0^C?Hg%`b)Uk5u9~TLsRjr$1bAB?~WP)U2j2W*U7HmRyTYAp~%TDg`N!3Yk zBLqY8E!s5N@P{pQyyn2RQB4)XZg+kei`TL85x3MBybH7PN-W_Lk0Z(>k+8Z@U^D{B z68PY&99Tky|C58wM6!(dv!OCq%h;#%Pw}hs;;oA=7lmGQJ{JGSF~Bp6?`S8Wj3?9s zc3!JPuh=MZ2H`S;I7V!Fk1DhL04}x3h#%Nl0`YesLUH0jng|!EwzbC`Xq7dBgteF) zU#S@PpJQjvW368bY7oVjSZ)TM5iPnN&jr$+4J$V*QVbz@D~T457Z}f}M#h_*vvoDx zB#HwsrdBpxr57I3EN>8hKI&!pz$3)^9W5~@@#1#l)+5g?c4p|%toozlRN?PiHgL2_ zf3KhOl%5M>cw5O$@a7j}+8TqE2mwaOu##jmyM{HjbX#+YHOxI2KSxDM1j*nbsD&7eOOUKzSh_HP1@F>Dx<=M?_*aN zscv9i7H)7q2*L_hPmbiCS3BC~%7dy4=_A*w7xN5?GQXRjpjdhNuu#3EZkeWL;00%_ z$pW~8uhloffw5A{BhHfAj6Ef-ctvq?@7ZAvJmz?tcxE>mDE{Mw}$2Q7%x<>sHw#|(AMMc^MeJ0Q9XdQ|C`KGMe)g&<-jmQv!);LIZV$UgpW_xr(0;4?iEg#6 z0cL1b3VrJgSz!6BjA0$<>div+OBirhejJ@%<&U_!ddYnQZYcjsq+0kvNVjHT-s1id ze8?O#7&~pw?lgI#rfZSYLA-4q+aS}}bY(FQ**5hj2vcU7UHB|zjEy(&rsl{7z7J9} z#A5{3n{~(sU)wccBLyZEAzrPaX$hel$}79nKvg7=UJ89o}9~6c8_?+lQcRYK9kdEL8dYa^LG_wfa1sn#nNDsf;5t--Z z?_=7&N`S_PGPee*!aXjrtG9G59}14Xa)`~jcK$WjmGLkD+IZ&vZuW4C*adRc$pMq5x-8 zV)R&lcmxW*0hKXZJG{XrSO6wyJ;Cw+Oc0!^mluBBOR}t#?X+Af-iQd^H4PJ5rm~vW zxDzAZflM$-WcRqOvjn6+Y+TN&@T~#6fm^;N<#cE3kfd3k10`@g`mm0G!If#9p#0>p zrip&H!#i9YFb_QU`=vJ{r5Ua;0B}*b2W9_N&8k?q0;^WV6mGplFoSPfMM|@>7sI-@)^oC3#)JZ&1IO8RqsTv?dCaA#P*|xQ;Mr9H7JxzRMA|IdLh60YW76 zX-;K_`#a^#bJ!M~_E3dhF!-`n^scf-0bNXN3hkP_f${hY1C5Pj@r}o)2T&g|5gWG0 z8c4;26`G6`Bb|PMiCW>d2TO%Lg~BynZCf)Ff{FO{E1r1_f8>6X|U}ht2KwLDC)SI-I=w4zkbCnw0)C zlXcUB2W4^8jIg~`l#P(N&+u+%3Bh_puF=3%zAhde-i_q8P8ygKSvE>4#nf?1u76S^ zb~kS3i*?6n25;uUa9MWr9=yXpOiws|jX?%Ekb#x!EOqcXJ1ZIVh;Z(Z>32remZ0!q zTNch6g+`S-RvyYcKDjP+X(&Xfo<&YK@+ubuKU{KNPd^DJWQUza$F?}y(B;OLdhf>MzVHHMME>Fa^$JEasXr>*f1W%~DM?lk%|&}C>!0`WYkQID`X9u2sUe1qVMDL4?A5CcIp6(vQ5&>8rPUcWL zXeKb58Ggy%cr?Q}4qPm;t$54rNqy^u?b0IyD;SfWP_h%M%)$xK4Gh&-^mc(GL zZ(DHi?A5uu)K(j6q**Zeqf0r4D7sZa5TWMA9}e2;mT<7k-&UgE&f4tLz?*L;DR%aW z`=|~Bf1`2H#1YMvz!?G1zP9x2r|d@3E`F~>FP#MZ3Rpg(X!VL)c$ZWBxHYpCWMh4$E*B>SR#dkdu`P^e5os)^#iyf>;2F7dHitCu-Quzd^TN<- zYxp(j9H%?cV4sWu_4M(kOH)#D=6!<_chkHMUGGwtYc^#+Z_Tk9_}-cxwAf1pQGA>W z4E}hx2*!oR!JC>br`%D+2;4^-@ApEy{*Z0aGzp1|=}3XzrLl51V4tpC z$q0U)1gTbc2d0BQQeo9}m{&%j{50@+lS*__XsOF>%pXZS;{Zt@1E6Z11NuJL15DSn z>=_qqy_~sGj=QmPj`qrv@vbdacqI73G#IYVv(oZf0I4T|Yj+#Xc}FG$eV?o`7yTZO z^xbiXpXJ0UrNI^Yj>JPszM%`b^8Ku0@Q~>^H>)7Y$L5>Fo-qv@oC9H_?`!wFSm>g)# z;Q`*A@B1|fXWcZ%7M!d8iWv?3yHJu++qtX3Hpz&9+wnfhMG|`M;GPP|*Q`0tVT`!shqVbH7sosFwJp@wd$v4VB zBH=?qHOoo*+fDS%fk> zhG6=`y@y;kszxmbAZa@fUyV|uQLgj^Me-=BY==~#G2~@h%ZS)qND$?z9XRxj_b|`T zKd{q~%#g<@IDj1UmSQGKX_DZ4H@;~H7tlexv@KUs(jrsw%X0Qe@dz z6`o*W@HtRzG|VpXWV*+$Im|;xS`TGLk8Qc1nX(0lkB;^m2up+V-NL=>u+hSz@)yf_ zP6y4m(A_;})}|Q#=uI;^I(PEO2zGhH^O9o&rSTJgC?+tjAXk;6+>Fo;gB;!$G( zD$AJ1@xfOQ0(zKQTalLxT3yX$5`F!|RPiU9D9VW9X2sVr{GU8*ap~q$Qa%bum=M68 zKIO@3fGC7xTj=@fUs+VnE!s@ zVOf1AT$DE}w*y<=p|4;WD`~#chhIiw&Qlh^z%Ojwggp!eraSzns%zTM@;=-+jg}LT zJGQ*lp8mXqLPLvrQW24bT{jgco?J+K+}mnXI~OqbT~zTgd`|sNMR+|K#hn?<^bt*x z4cx6ooH?}{`nfX0YD6L5=Y&~4_wzc)NX4c^ZR%HZw0VL@SjE3Y((Eq~S#)xT4$i{5 zdPXD#7YG2N(dmz}13=ulhV{1mVm%z_Ei%8EHo-@ffsZONc1vC^fuG}uEDtv;21U5=y#J^Kg0 z$#|dH*%*8$*x)o{ZpN2pL_M^$LyrH0R?B-x6$G7LbX`4E^h_2Ok(xZJV^JL7^Gvq7 z_t(=4)X)4nKB%*C@CiR5@6`{f+)2jVYd-NG5Ak)$=!xfFEN4iNE@8rb zP8UkMC$9(tFC}VoQWK+m+hJL5+$#Imzj2Kimpa;|;yuo{rVT z_|lK^8&pV;s(;WmN)C(UID!i%**4T*)fRB&#eS`>st)vh@rsMYRn{jiEhK`AKBPWv zNPRtB3KHR5HWKyfN#&709_RF4sfM6?g^?qkIy*BPsV=C?_LUCZqhXEJvKNFWq+@H$ zWk$}vqHOh~CS5nUYo_ew zn62oEhY0f|wjbw>9qDLPzEEhZ(w&acs#z}79v0e4D%;iag?540v2xv% z6G7^V7<9alJmt8t@hb3(@Zrn_r+OM1@?e*e?<0h(NuxTQ$9mZg*SHJ+ z(}HFxkcZrOyFh^`>JSLkTq^OQcz&1!Us*PY^*Yg0()uX{iUD3n2*Iw*fU48z7agYj zpYzjYR|`IfG0fBIV@r~zPrI|!FH#oArQ69D71ANQ zSCFhBm7V&g`e4AbptMF*wJ&73hS>(ToM;gihqPM?O|66q|DbT;P$l}Ra;LZh#!*_N z`B@lk6iZtEGF#i5QN=G|shB2k&yW9j$z!qa25-SzwU4jqO0!sHEYsBReBDVu5o~yj z^kpoeOY|1fTBQ!K!{$gcIBp8@CW6GHYB&@3E6#9kWw!YcEfa z#wwVNm)$N-mO|~iPb=!QZoj|+PLqkObe_Wn@|*# zcZzSA4^nuI2sy8gy}O{=dB5gWJIa;XJmRw-IVcp2o#Hw)6-LtVkcmeeqxIHNL2;R^ zYx9yyp4zXIIL7vrZnu_n_t@Aa9_k?@O)v!U>a)33QK_j!~rJQRq*w;$Uw znooY+$#Js2Kcy2B7m8YJu)yRc?~O*sSywO!fl^uzzX64ZnAJPU%M;xDE~0ssY-7r( zVy3L)bIin8+ z#ovh!I_1Y@TilCX&0xUX)XI4@bR(R^sb`_gFO09=IkeYU_-w3B9u?zK?ZkGnp4H&w z0ADVi5Zfxes-4hZrQ_)xnYLNDuA^(r!Z7d9H1O_-;jTLM>f(eZiEA~Y-g@&bPyDHv zOvOU&k|tc5^x(FkZ?>?@&m(uIWF0Hb*gY#xc#Jk|l)0Ya5$c%cXVVK7S{stuof8h_ zfhJOZhT(k=1a_!|yQ+j}R@qBZG|%+KWLSpBAFw9N+#XiNrs%Eil4o3v!kF4@mHlzq zvjb_Sz+&Cla?8OuFAbpwLt>l5b%zfo<158LWC1A8o!-K+H`BqnVJ6lJ)~Y$~t>>_M zrZYMV(i)qz#mc4$JC(+SpMFb?Ynr=aqGmJQqdsQS9H`7yVZ@QJHtYTHbT2^5BV2sf zG{i&jXZ9JQazVX5e^*jav_7csS^b0gdZ(5BVU7s~SmcNWp`|kZd+RL6K?60(^wl9k zqYKnK(J6;nIW(IK9ddHItL%E&(4@#sFUD&{&>+uOf1uq< zXxH~C+cZssx`>rz*ws|Zv!$>D1e7ENQzf;0yF2>aV(FO&>b6fIpIVm1RY-JYD-BTtZc`db2Nm=3uLuR6qUA>R4_)s(OD{Pk!>zv$X1_o7fyjE(LY+3G&H; zNJ$cTbTdutBOeixA9g=eXv8`=F03tvs|)9)e_c`Mo46(BW;2=E%UH{fdsuB$HfrRJ#msrEmVAJiekLra7Sw>`|(Wr@hd1p-~X*D5R}-lII#ctSVT za;?pR13>zIhm+X-dPjh;F*AfTKlzadf5OHdpwqg}L1>QVU+&jG$kuZfWh2f}HqKbq z?k5n`pq@z4H;cOu+eGt0NRfVbt#tQ^==scYB@24WI^C^Rcr>)%$GiVge(-|6-3~NT zjm=QM8Z#u9UP>}Nb7O=Fh%`}T7uuO`tNlOhy=PdH+txN}0~AD5iqdgeK)OnAK@m}r zCWO!tk=}a;0R;sq7C@;2(o2BQq($kyx6mTJgn$r22rb`?%k{o{@3p=k=eo{y{+#`f zOX10rIma0D9%J0&o>kk{v7S=+=b7kdUoiaa35F615p9Ik()`y33+>IEW z?b`P)HoAH&=r*qkRW7Bh5nt%)5H4;LI`YHp=r!+*(9AyM&P9G2=@dT4Ka9<{s*mN^ zP5EAa?GO6_r?|f`Fubm)uuuJEXZP^{ulz#*CBwZ>_7OUSkTq&I^)e?f^St^NBDLt` zV(BiZDPN##xtpuNJztQ3D+`07yo`^QQ(t_SzFA@Wicqm5B_l`haHe~g_6Fn&dD#3h zc^&h#jX(QFvBpkZp+U9<9@p_lJ|NW!X9sN$@cJ>$>pQ-vHn;n_vj~bXjLavxZTqq* zMdZk&8g^H!Hg@6oOFJ)jmA7<7aLq+iE00YpyqXz-;6~Um#|%C=)NSzU3#KT~cQ-D0 zii2M75VJ#B#LV8AoHa_aSugQ>Fm5^zYr(m9zb;mc!H#U1jRfv?ad5RmI-kHzbG_}- zN^|qolKkNB-TJ+6lnTjnQ30qB$FlI7#~pZs_X(|8)im>JAlq(ddzFWFwOuyOWdp=no-n%i2PQt;^k5&g|{))jY!ceP1 zE3I=m_<~zYuSGI4MvOm*KB-8k^Nv)H-@PEN2Q4cL(~C*SRWNXZ#X7j*T6ozRerSp{ zsts{~-ml*^zP!8GTN>Xvx5GjtgdcciY+g1M{RU-Tu@A^I)3TB%xyb>eUL2?eg`1Mi zTfRF#R~G@0=R|qpnKZ<7uKFK(YKr+y;O@%lTuW{-BE6-X%XVSY+=U*KoWZvS2#upf zlGvrIC8N`Ib$i8@WHOu!VP{b4S^SMHspfknu|w7=QO7G7PQ2x05P8y4@4K#U_MO4o zTMNe{&nLGyKTwVwPcp*A{PvT$q=p&OXSza0<#yY;gi*5=BRdb&=O0=fd4qv$-l9?c zf-8z#Mx062w(K(@_|dY}eWtAUq{68j{z+d4PVb0M{sVGmvW#=aDjD}KsH9J6&7|rc z|D1_g2Yn;KBwrz^3NhuZ_qf7-gv-0rv%V2=jO!ORys`&u>Ug(@SwoZ0*oop);+DVm_n3=(#=m_$$&^E20o&VSrPQ+bZK{n!V6Mx+C z*^xhrBc?vo?e2L`s&01zNC>`G=7FmFf-Tz2^KMB?Mr@AjZF$6Ch2n)cERJSTHx7Pn z2$}a4GOJ4Nb@O5SW{bSwr>&bJwP(bQ(JD=TV0Y5wjGebZs=rL`9Vx2t4{ zxtgX0tehF5tR2vs9famivFmR4@H%cq+OR&eh_TO=iKN1RGlAb|BkVk>^;x>UQ!;N= zQ)_*DeW^5+Ke{1Va76lL0v=VJ;v^Rl}q{Z zoT)-xeP{C`WR}R71W&j#DdT=K`vPM@xcBY*qDyU$#^q#XtrVd8qTg)%Ytu4T)H7xZ z?GJS_6!IQ=+B_Qtmv8Om`|Dn{PI*mzSmdXw1|9#*J=3Y9RtftbU&(#kJj)H6EgZ#% zagLjd?tZ`;ue8YzFv|KFmC_CurF#t?S4XKcwQ7KFikYrrUjOnlo^kYt;U_2Obo}r` z3jTti(ax-vRHBZT`0}!BY!O@wYIbuC)uyc#!M5!qSCq&9@eZ6=Wcn(3Un>d*GjxNd zP~THFPQj|ez1m|93H!S968ZCa8n*?#Ba~yvX(+8)EY%8ap6ybP{F!RGc5&Xtk*h|b z0f)F0R1ee;!R&0T#q2Pm;dDH+sxvksc?_zagM|^fBx=R(56mCeA|D`(yL*YzL z;NuQbg;B-k$kXl8+`>@o$5f0UJI=1xEjTugjtlO>0e3b`p9eLWF%y&&hZeKcb%)7h zIJ6+Fd(SD@O5?{fTWfepf9*$FXwLySBn}MkwHNx89YR@7+DUiFb*$ZvXKxWeZaKa% zB3agsw1L(XTEIYyJ*)mi`dcUqGA~)EqfnupCB;oPEBO)jV|nMz4iVSYH$G?HXqPRI zF#PEt&pE1!@nx_#*1kznoL%VUUf$^RHMuFV4b(F}A)uMLY1$D11&2A#+#ISB(=Qww(mAe!PIbX5w~w9$q%i{WGFrwxO9o?R+)jAclEV>%_dx+&HPPWCuo_PjO|>X%w_a*@)#MG_~LPE zTqVT_)o-1!_2nMhyaS`TSd{ z-pPKaw|-O{R-h?P;XK%tk{feo_~Ym15Ko@GyJc1%IK8tr?5nX%EDq3+p>O7a>P}oO z0u>YQVnm^O+JCx2skKD^KD6Ca*K8ZmQRvHc8QTlC1rF-&G{H1S-&ga(yLg`!+~8Y# zo4)4s=oZ7dM4|!s2oTBh8()Uc0#kQY{ZDQ=X_m7ZZx}H$iypNv)hQ# zJO$U}qEuDgZ0|QCC3;xg!MWDd`4v&l;frbe0}wl8B*OYgD;-wV7`Pemhl-Su8ZY}s9`_~{fwK{c5RZ24Z>AQa-FxfDv&M709RHLRiS8xL_L8& z>~-StpQ#+WQG+}tnIG;Oqv=zYD%-{mku3NDDL~kztlf6CD|GTM_)P28Gh4uBD>-h9 zP|>>^lMiF!lrk+2OfV?utr^g(z^qTraE54*gtp(cL9 zc<{62wf6g{GI%-s;c=6<3NnSDJdARh*zB0VYK{~rDi~&^iOf2g-ilVhY&6oVz3{Pf z>CIY8cO&KP=Sh7TRns?2u{LZ!Cb=?9)SB$xcP&_BU0ItY&d-zV#Yx_>(dpe~6|2<( z(F!e6_!HS9EZ2n1{jvumtfysj*Od7@TxQJAirEi~PcDqy6THVN+l$G?wG4ddi zeB`z=t;=7b{vzWNm@}{B+o`nC!|Y0vu9y!!QupX{N0`pLIK!9vUL77b`5wn?5=Dhu?EvJq<6o=>!*e^simq(npehqU z&K}9)52mggoIDJ=viHV%$nneTybl{C?Y1_qiO%iU_gv3SSX`CbNmu0xWrBeqPXzh5 zYYDJzzVKo7JSSr6_;JbnKcMj2|7O9At*K_1%g`D6e;!y7WLCa6j1q zZCVK)pYz(|h9ZNK?h$~2u_IFr*m6vEMq+|z;(Ooch-tZ%Er-jwC94xPK8H}`>k@}; zpteOE5&S$`fXYXQ%h{BKh}aw%EIsg3ZH22HuB&zz5JhH?(vs`ehroo(&tQKWap04# zkR5O7GgoZfDg%#;fXvah@Jy5@EE% zcO+lsrF{`!h*JN>XR;?|9H^Le9E&&0o7L-6Z^_}Q^_&cTr%`%-PH|lyZh?xzd{29C8H6*z? z8&VjE{mzn+3d_*_hR7UHzY2N0>VwT6$QGR?xdZkKm`t9$*|7DS1SA|n;SHn#E*xrq zPs{R~4SVEM?*$k@YdTX^{N;pidD5PftJ%kv0F{tkz%cwF?3r)1fU2-OH9d_lqf;rlY`)%}4|w@6bx9kBeW1n~^JKsMsY{*pLrm29-aBrGqV z?|vu9jZ;^g?sr(1^$;w$LhbV8@MBCACMy$MG!$NWHBQ`)VczbaWe~S71Wp5)0 zV+2?f+nAB)F&;F-{-|v)W^uK$klK|sw`y!lkvvlV;N-E#yVPeN2iNdsFxuvY(6YM9 zy&i$e`Yo@6#trHU$^t_j%_+)FxBgIhVyKP< zqDNa$NYq2|?Tod@dz)K|t%AC?iQXinQ6UfK6#y)jeb6%pj|OLQ18*0Ev_I`2`epQI z>*c5yPAh$CW(G$Q@k(%PD;+3PfzYnIVy4pJF#OYcU*Ak4Xh zH1h^F$bi4Qq$kbitjhSRgwY4%Dhn9LlJ{LW3wV0s zrqw*Duz$x8@2l(1-k-lAiIfACRPVtX_pVV_LE%>lLVkl91zj$sFsT&nah ztr_=Z54C3NIQlj8cC(B^XH(mEzf2MI3N&l{ec?cy0c6BO$~2n43)Bs+j!pGA!RX4vH&tl?&YUHPZ0y2OG0)hp2oG#c}LWZF%+vY`^FLG77{ zE@Y=>wSR^Mw5lGJR>Zm5aD|o^s2*zNxW3{$3za-erx=sXwE89MOGgkrXeE6ptgX+q zC56S=p)t0|42^A6?(}_79hfzXK>;#{ZF!Hj-%5e4;p|54V6o}#eFk5dh&pmemW;eU zsSOVPHHU}e$I9wR2kV%g`qYHul3R0SZa&qZU1g3j&f?dSZMHEf*e2cp=M$?xaFmde zT*{M%h*FmJOd*=NY@fq7Q32k^3T=68OK_!+@<7TiOlME(>(Gf$#l@tTw%xss9Y=kU(K5O9l|td8|nMgi#@Bvtzu)6 z38-SY0nUTDnF}E7iB&CIOdgaD;d7Xbm|EYab!RO%$Lx>(g62jgqp|57n`*azO7&zD z`b&-^eP?UER0;Yuq7LGqakNM~pK4^MEmBI~YJ$TI6+G0G^=?#%nRN}o`j}xD;GF0@ z(2KdvrG)RV|L|Af);>Y$!WGK$3VY00oMXjV43eFo2W?&QsAWkQ#o)N>sU)l+Hff@X5XC>j(m7e4}PTVwLUn$&o2^T1TWzkm02M_oe%=yA< zu*r$-%~{x1jBHckl#DGik=qu8;hpHhats(pXpQ|udi+dB%Oo}hTpZ-yz>XwUqhwaR zbq{w(R&zQ%{lM_UvalaYrMP^&e>D@9*P5ydveQq=Tj41Sul!(oRvATD>mp4v3mFDz z+8Pk3HQ5D4b)jUDy~1W0A6bokYetpN_Pg`>C7G1(({4wEY*Y=S4%4<~ov4lace78& z(gMVeXkP_neLj9uFeo8Zpfyl3yQx<$C}tGnGOY7>cp%VzX))fWuxQmcij5raL;v!F zstY61HABh@{_3--RiV(jruBCtt{XNS3_G!$AE@HhVz!e`YcrMFQy=oOY&|S2xjAK} z`zmU~yFeB3eVbUqo!#Qf6$(9)tMr9e0ks9dpIc7~^!SX40ys;HI|^V2>K)zPW4=>Po?|(!kIp z!B&^pQ{wj6QL7Ilfy3cEjE~M|v2R2K#Nq~|c2_~% z*!t{8uoH*`22p=T=u=**p&bYDTi!t;$*O8)xjuI$J+HsIeW6k@Shmjw?%22YIzd)4 zKY>d?lhHo6COnvT@M2z=>Ey{gpY=);nYyo$DF#DQx+6ax!oFX0N-tzl9t;k&vpB3B z*r0`HO8$6$d^dmKR*ww*R9+4`jQ1I|*i!8v$4O`MMSC}8?bJfF!kJTQpB9fRw)1w{ z8u`_c4)>;^Y-9cfHZnTtNmcGc?@OUnHs2mACT*&T^NGoT@?C16vRYsEjB0TEhjL@a zoZz;%OL7d0-Lt3?O#?%W(It`JFg^*AAK?~ z$M+KJ;g@?}$7;z~!>qi$!hb+h42;P^I>T+ikgTSk|8Ah`s{(5YLQ!8z%XE*4TO=_=4$e03k&14%3V7nqTH&q5iZYT zG-BvjrD_-Qp29KWG$;Bj49c}4-6D%Vo5=>I2=SG_DFIlL(z&(e*kHkJG5b<+2n~OE z2^%u4BeS?iwP$wW^ZvkB{yM?7ln&RV(eB<~2W*#q)83sa03U_)X?|$P*Gtcay5A*DquaCn%xFc+g4H2kdI&W%&08C|CR@>~Jd4{GK!(_1Kn0bp+ z2Rse0EhNqYcjhE~%oLG!>#qSxpMj2hT}0OFC@Z2Xw(>0<&(Ow5WD~V}`E4_`@4H0r z?+*s-O=h6oDSvts+(#A z=G>J2?G;~B!hzI$q%tu!X5M@}9i7W|VTFURV&D^pRo3%B*l7EU8X{8L zw=v&Y=G6`-Y!+FEF6bOK0UVh=0O@eir%OWQM{2^MVWH&Cr}QLY%#a(;WV%ReIC4u1 zlpQYH{UF284vxQIsJvoeAX}@6I9HdP+kh|N?uiXW2OhhSfBw;Omn>l-qKQdAUrqQG z%ln!32nh|v_`KACVZ{iiE=t*}_V6ctGF2wp!68AH^53e?ich)@$OY1L9g}o*$-Jjr z?bW9eZ*)A3nu#^5Ju7V_s!_a#`c5BU2Bj*5QqqhILXX6FKt= z;fHqhO$%6_+16zCMP%@9h(s)aLvNCGWkwH8F3yZkT9G3G%Trf+cuA^#by%{|#)Ct!1+`6QI(YJmrPgl3P(@N>AA z)TDpcILNO)*pm94-B#5l`=oNt=_$nAoXWqcZ^a|uz!F!=W=A@&%>P!>dII1)ot-aV z7lc>_b)Fh3+V~e#45K%pfp*^UN=QZuXIF2wfhwKL$(#9>ORfQ$dc2|K#@3S{uiSN% zskkQqeZ=85s9{n)MmzT^WozI@Te6J4SqwBx%(T==o9P+5xHB(jez7hlKcvD}G5+fC z12S9y@G#Y-h~1)8NC3INnJWDRzyIZ?09}l742%}5>R=DH2SkP0uw_*ib=!k>ISgBM zzQ-x%m6YVuWw5u)jCZN0iqK=H=6Xe=*c(KV+opU->!p(0vL|(Vzhn-GR29C88hV(O zZSo~IPaqGqxQl_O*kyH3Dh7Ky-J*^(INp}h#nG;OZyi<$v^G=70xebb4oj}U^;cDK zYVi6J-;vt)-aH756NS9{u5}Er*;mx|s6#;{&Gks1BqJY;Ui0cEJ_Onhw=+fbXpaYs znuMBRKAYvjL@11|e^VebQ^EDQLWhSqKJ=CC0?f(0HdMw>vw9s6Y7o3TPS0NX5>8-hd#{h&m0MFa>3lU-A3Kt6lnNQYL3_ z9aC5>2=PkSGlxn}^)Nn_6mDuM1xmRMHE;ucl#N zQ$Y&*a_QM#cz;{e0LCldNozdy zW?Esio9~c%#+!=VPHm~&UUkPfSruC|ZN}WO^)bn*>$0>r-xfosvfpWV`Om!O4#C4_ zGyVCf=Pt(7XLAUTNk&@Lfg~V46Hp^?R=xC-xuqo~xd)FUjK-80f21dK4)XK@dy0&q z{sYncU_LPNHejKTXH!({Km=)Wdk3ZT8ea5k$){8$M+QfSy|b<0pNra1v>L1QOsR0% zu$YL>4hi4?%yBl~c141P4)lh{jASJPrucgkcu<**=%g)bB)tyJK zRzioMn11V`dsGGK$vgtAT22La8bwc0z4=Fb7nn5{Pv{%%>k>d(9rG)#UUatEdS4J( zP5q>3(;QCf74?yE_3j#JpNdVL{lFqVgMlWI2A^b1>1^G#?>o!c5bnReE`J8!{A4i& z07Zl)V|^tk6$pMXQ^~_A=A};Vopb3ezN>A$gRr3&&as)&J`X;?v4J;S}+id#O|7v-=K zs;Ubg6k}3<^#)|R;U#9PB^`pPk@AGw?)(U=akmm;ykEH#T3gmw&re|pDCDV9=MU5x z`KF{}hmT)RstE?NO;V_DIybUUcZ{V}r^(bB?lu`cz!U(HaJ z>$`v|`vHXq?g44oVJ8c~LOVTTJ9Z7%TgO1hl$|C&la>nA6^!SG6b?CE8ghcaw{bA+ zXjLX{E>7{ziz5pZ11iS+hthdowX6k}3Fc~Qs3WilYUf^0nz>$QS9r!qx$d_DyUrys%+GG)Z&?PN&y_o1AEeN& z>-)6%IB~gyy2GmOP4W6}w6G*+_E|Yiey#BvVBAQWbFfcDa=sS+;nctmkN>Y(r1eAD zgl_Z?$$;aF zLbFQFvWb{=Q+c4zZ3B$D%=wz-<8Gf&$r4ccLgSwu4*`psh-1|0COrM&`&>=OB?dNM z5RhBtu8WWG?1l|XqbuoUq*FH-ud0rx`?bI>!XBorY{MRQs?G65)XS~1QY(1DrHr!% zh*NTjt8>HoHRbQ?+RGdmvTZ-ARYM|8-3a0Z?*r&caWO=b@lDLcGFnc(kqCoIaF)*c zD(cQZ`>i8TrODDPKEoHpi8_rv`lQwnk*fKS%077l>U|nV#d{2I_ddQ9cv+8UzSrJs zprrb$@!o6={NMpW;P4cte7$F7L3#3Kf7_;;436%>i``S4JcAF;oBAdXs$!EJG#!d! z;Zn^gv$v7xo&c~bbW^lK4)FzDzmXF4urZ(c)2O7!!{+{ia+;IbS{5X z+w7gJk*S={uzstugIx50T;8tHyz!9Kc>!g-K~&;!gxI0pa0t#W82bN2%s1Ta6~oWb7m@qcLnluhLl)?)EM^46Q< z=3l3p76a%s{4vOtlFuJ)8tovK0K5H}Cpx{}_EFH0V-&~CXr(CL-=zL69Y|SuWbxo= za$vsPF{5wDJA*`6izLbVW1++7l?JlnF}ZPJ3CkyLop2T*Ov8TnrI+M^5b~K`%4z-+ z&Zp}isgyoA;d~|N3iFAYBeYTs$N&5-Z>8rr|MfXheJKeF@~AkFpgkO%^u=}A_bFar zPh@S=zVuvP?HAX1?>{6i$dZHifgE7_?N7i_&2GL?`s{a<#dS>F^vs{nrpyJe9T@MD zFMcfj1Vd};+Af*raG(6fx380B0&V|6`H(BH2SS<~sg5w5`Pt zlc!{zz&)65S&7cnTqn8I6@CEl>PS|c0JH5IKnZz5Y=Ei2rKQ{fVLeUlg1AuaYgL<3=Y7IO z>Ff*Sj@AHS{WPW!Z$TzDQ>J|b;>C%F5#m#o_CcqbIbS7wle+v5TEVB~f2ppsfYU+t z0qt+>QS(h6DC2hb40Ac)o`?DAKejWP9|NYPp3_Ra@+kuS%K&2&$qu%pN zFAdCD|C~7e-#-N~rI-)E6utjI4CFuFm=5I(b-Ox1#xmdeg`a^d36{Um(=Dhx8~>LN z|DR_ymylQE7QkcwDy977^9koSY{YZKmtak|UVH;nt^M@lZTJ4^x{^2S^6GOA?z z2UJNmPS-f_kjWU%eA>U8n(!!i?EQpvppuQhBKrIL`~(Z9eww_+Yv%!4uigwU`y~PY zFW(ca17!kvZ(Tn8``-Q~lih0w9^wk~FB1EgulReZzdfNR*SaIm|94aWf3T^2$fh4) z$i}rtmh{eNGsj}WBE@eF^tc7ZdkoNypk;P@I*3kg^)6wQUM&>ObkKdw9$6dkR)w%1 zVC0M>VkyW$-BI7J_-z77ANLIDwmBadAiEOD;_fYmd4QB^?UKTDqR_R6^9^(mXEhn( zqbC<{K6{nm(haZ9$%-$z+7T{Py8?K~cH$L1i`TOfYv#AWyQKLnCY>{>0+h|MF3A?# zwS5}6V?f;k++^Z|=A*UlLu^s(vha7(iMst2K0>cTR5hvQXUQHA{F<~y_;q!O_axe9 ze##`F?;7q$$VUoxvuXcR6h84Q2HpKz4BE}QXy7v0wMKWrVEXW&6Sp?dBZommJGC&6 zbZtcFPBya^V#UUusAO>+WfenP(|Ppx(Y=Jk8G4`cXtq)cSqGX@j(PdTIX?44BMoRk z-*{QQJcgT`d#_@RC_nJpV<%K%-6tRk>nnWS?k-)DKHDDf0OsZ6lCgUJvIOE{3RPI! zwWL8q!lKKB>wt>pLl-Q*0!T5k##m@RlKWJ>(2f>QI_&R&yHRoaKaHJAuC|*k-$7BX zRnqskA|dN)Ci^0qYV&KA^Ch+{bsuPWT9?5Bx>}_8y!Kg~)cAfw3=c{pv;L*Sy!Hgc za_50ZlTutQ3#_auAoSC^#lHS~{QJM*ugKCSd09R-=f($X4gtvY$MxX?CDGFR(Xtb( z#wk}H0nXh<=K8b=F-C0l{le7?i3>~yKN9?!%W$BTR!~-sGJ$xsBoWN%IlO<^0~Js0 zp2O|{lxz6p!~vbmyND?VIQv9qLVm(Q5~*al=U|Jpi{2U`&DW?iot$e`j@aFc3uRk3 z^4u`1=%?{QsZn!{%OX=9o1EO~`LLfC7K zFM>;gQhoIt8n6@Z)gY{ydt;rqLZ&#b#aq@(r0t0@;?Bmz5%1BWB@ZUo#S|QpL)^AT4zly)%ifeT=Bp5L_vV{qn@H5; z5Gmt-BdQ*biT;K<=ei?~WnAezJ)FZs^qJF!@1KmBSx!(t4vV z->X>{tl8luG%XreMu-`7bV)S0>c%JeUW!gH8)J1i969(#MP~`=`+OvDy25z6nXK<= zUbplPS=kUJm(k-%u`%I1&}6?GG*UdVGcrD5@57#~g6xWAtv2)kmk_CNDK)?I`-i)rIw9N6>wBgWC#|^I7cxJY=h_+^cF?QI&1NQBKNKH$G++S{rI~BJ z_HgT^e57?Wb+6Z4aaPIe9$Acpxa-DC1QOfPQ!zC#>9-!dZLv-4IB<7{pd7KQ4tr@M zFASW9@Y`9{JNp9@pqA_nJrl^rth}xGU5z_sd+({ju4Hql#Tq<4 z=dtY&%J^uAJsn_?NZ%&{|FF5=dC6EL@o!ip-Ty`}pQwN3aL)ul!ffYR9VVP6p>YS@ zxWQiWg6_q|5oy%V%?|k21c%xID=EClO>~XR*Q+6dtDy4z^gV-r z9j^OTFHKm`Q@O)AP4S)y^hu2PxUDf?V%__|aSOJh?%nhhbHbluR zbKq}Zy{zOvSGSDYs-Ci>Cbe_0a(Hb$AfJP00#xOQU+i^}9J9Mdx5Fsso4}-02a-B- z`r5}QzJ!LDIKFuPH<~?HJkYq$JqV{nBcXKI?$T)LO)t{%s7g?rZS9gB5ubP(&c9@y zhd}kH->Sj3O*zIebQ^>;1V`QTc_Es zysZl5T(@Rys5OXrAQng}sa`*rqeRn$g+z$ybg-9_x~F}_50$u-#22VBFa9C=ar}yY zSN|6M@Zq-)8JSu4?#&#Rw!LBxu0g}Cg;pXD4kC-{Y5aZUJlbAnMU`*D4vF_XfOVVQ zzPfP&{n1a`qx0OJd955-zI10+ZQ>eayh#@9|D{i#%oFAK5zt^SwiiW<_T!bOxIcb7 zSZTa9X^|2^O{wve+Msgg-K}~)vqS(7xmjs9;TvR2G9HJwcqAo;YV_suAE}oW!@`2(g5?8EI=D5EMQ|l_uLVL5i0dXD*zLRtF=3j<2@k?hjPu0Ty->Q4_o~&xkn;9+z84Pb z2u+DOAMW}2HM_|MwUkOe{>pE@UXpbOH*QUOhaTshXRjFNPjuZkiE%EQ4x;Jg6#V*Q zPI%{qOFgUZj|}hd$i-w)iTsUuD6XMLj?m%w?XxLg9Gl11=ORqEKD2#ES{f_HbGj#p z(`o!Eg4EXB+&7e!g@SYNVe;`Yj)Ui@LcX`8$aX!tx)EZeYs~oxPkd8%i}Fn*WVz<& z9?U2y^HAs2LHVBG_zMLpY!a2?O!0&F*IvR4Yuzs1a({TAmjh!deM7(AGK*boeM!rI zm6%fdvAWda(z{ASmw8FzJ0-8wGw2hND@B?jua6u(cH-n&F8Sxbf9Sn?EQoF1J(El6 zYqIs_KmYmW(c6)QbivB-${Pk=csgE2LzgC$Nf$ie>*M64q{0)Dk#gJl!mFv==DTh; zv>ewB6>y*Uasv{h#A&MuRX@M>2qvL9Tbc-wGNLlEU1{ek^nlP$2C1)vTUT!D0EQuS{ikyv>U|L5NE{j?-V_=IU4Ux#=Ou zL78)nMNe|7MHI)t{twRMj1`lv517t=B<6F(JTxys^qKp-7(x5yIX7uWO>r=F1qn2j zqXU&-=HagpZjD?G@fiDruJbnqk#isD>n@a|-3Mki9lP)zFKC3mmOrlB-9*&u*%TUG zhp{%x?eXjxpSzQ7u(hFzuJfxmrJHysG)un+?kFU*na_J(hOjnB(@l9Om}N%IOi2W{ zl}oehFfa9i;v$Y!a+s@2XS)tjcBQK7QQUAa#FA3wgl zWnM0TH&%WzZeMpLAX&nvB@S7od(oKj*vit>Ckn~6YEqx$=JEwt(A@<48l#KO!-GZ2 zO873UX%L%BHI*;qKXy_6^H+)!lI>XI+mX()L-+pN+-G2C4LK=?ZkaWXarpeCnnuPN z*hcau4{)`ZMnUM$bOc>!Dj(zJ3kgOdEOh*TSTs;^MxLaT+t;cjQbA6$I&4Kajy+JC zi-VFRIO(*gBnzt+h8^4H#pgzvGVTaUt$+Cm!N6nUq> z0dePsE{{dKu*Ij78~CIHkB+!)PohV_>52(&2haJafXFNyc9>P@jIoYgM%qPH$%8b< zMOnJJc?o?*-(j+tjPhpp~TH=O%ypMr*l^kE!$qBm%Hzsw>WY=_S9>_YT2GUk)PR# z6j>eeQnRNkm*yM9GB|QW`<3#NFX89=dY^R?H)OkjcKDQ!d5?i@N_VV_u4O7k*wcAj zBCe2H{NRZ-((WrUWP0m;)JJpOl=ddK(#x$HN=d2L|IOKfdk0=)I6KEvp-Caxj@M%S z(~P1|opg5fyJ%a}WEAs5e*gP{xR8uU3qrp0LA2>i;{%iT0t9N3Cnjm%L|exnwHiuP z&N@ZeNPpu%(QAy^Md9!UAmJ2W8{C1xsBRkb_)KZ{!GLSeZm$KW!Yqq2?TsG$deijYX;}l$ zsn;<+Em0|FhbNze3O}98-q%S?`h)T&*$C!ed`HttuU9sSRIs`1OHLnBar8trId&@} zJ-HgoTd>*REnZS_B;VA3#70j?SACuCIhecfuig%kuBW)5mXt9UixE0)ygSn#qb$~% zOely-5f@BynYab${HL(A2cJ`zlUm zZ$hZyXmF;W-P`ht+Jp3>VeyKB&ara=z7YSPAD*-fjZ85KR;}*tCs1y!Ur6qZl~^8u zueYFO@Ruo>r-+Ny#6XGhrenAsar_+HYSUG@VO@v4pDA>5o$Hb414PPHLeHw>kMAuZ z7Re+te_wSmn)cgNtI6w8Y@$*=k=Xji*Yvne<}5bm@~KUI;wpV8hm*5Ef1Mk{m!(eO zDUTKA3!&0$984a##qb_o+aW^B**5x5nu(H^?Lo+UCgJ?^!@Tv=-uX5q2O8NDGb{6Q zHxcbHGtaO+4*#uX$Hu;_3r&tBIyh~I|Jp4tqK&R&hR#!qEUY*kH;0GieAQEKN`t!M z?~yU{PG?3v;vAPQ?J;CEtWrwm#>wO+7k_zd!oGgedC+OmlI3r~`_u_?@V@&G!F!_x zvvb+K_+Y6pbsC52Jnd4_1)Op;7}6F;f4y#fBh>$FtU($s!?2%o@q(UX;7^nC)5^tn zTko;@UrzK{xRG?&YV7NM+!3ygHWd}{jn%%<>G$*qPln*xpNElC0ud+s{} zDWq7=@D7tiw=oT(|7os9t~(PmooAH!>+aX3)YWb*jGOGgI7OUJD6HnnKg@vkE1OsQ zPP|sAk6H^Tbw+pT)~58t7Pd98yuUWzlGi}9@$D!T-I*RaFkCz#W#f0%zzxMb-KZ&e zlCZy&y06p2FMlpr@HpjGPe+r!1sFU@)y$p z(Q%0i8zW>)FEqM0j;0gZUkSk3P_cicP&<=&UM6Q^;=8Jpb{I-OSLmRNbSSr4H8S|T z*-qT>ytcku(@&%F{B|kSX|5*s-8MAcxNVt+M&g3YI6GZFe;(pceB^YTk>|tteXvvZ zov}Y92|=mE11H^t${Lk)+aR`xe$BB5e}SdHP?O~&fRLQ`RHD-j)XIK)-KXbVN+Y4) z0f;#jXXvGwk%sG*6SOVSSiJRA%RYPT(|a&i)Oox(cUnm9rt)<7RtquLe6HG9*RSks zz>)Rjt|eh2Qg)DG?|;DPLzLt;}JXYWZK1HT(0_!wbv2)%JSWo>60R6S55qw;&8usW@&L1#2Vt)cu zF8Z@`OS{6Js~Z;eCQ8YAIhJ^#0v7wKwf%=)?(Pd$TAc<22rpc^k-3|qLNY#R*IP1L zs@m8ukZ#T*bfHP(tGCnJ)oXAAx1WJNFLvUS3J_=Sz=GI9Io-THLEeK~Xmq@X?`LH% zD>g>UnPf0hxw~4IM@6uT%lZ0E+SONX%;J2ITQ6f8>S+YdavZeX@{**KJ|q1MZMAYh zKtftA(k**p&0mi@DbZ0|B)aI%$InJdURf;}h>dYB9{6NZQ;6Vdaqv&*iY{IpWCp-< zsZ@C1BcOGyT9g#uC1wOk^cns!!)LMkDKZ9i%DHAU6cTFZAyxF41Zr+D9mGaEY8C(JZ&t}gwn}N`f3V8zKGXVZ`m4-SJ|sv? zyPyQ&MNwY}M!OwRb&LCU~tG(KHgmJwf_5>*Xd} zf|9WB@P9;FN1aq~WxBKUFnTsDuLPx57=Lr`fq~pL!ONN*cD*LtA>1j4x`#1NR&jEE z-k}7NYzBJ04jXnx;j+)Fi>K$tNCVC%R>!yR=kPcwUxe7EWKS0^u$}Yp>*#W)u+fNa z^kpN&Y#~)>TmY%1G9jYH;l*?VNvH2YWG6Vs$)b^NqXt*6e=k+w}T{@zo25_%$D5fz#`7 zpS8-HTgev5%uvy;jqW=q4Np0LL8MIh<1$Q!pxPf7_8@KbwFKGokq~0da@`-4BL43L zH2eG9aRr1BM5w`y$s9(QjvzplA2J~Q?~|CDF&0-_H-0pzgkEO|>Uq0+rWw0a%)s?USsm&uJh2f0b8&Exu{K1Es6tG;Qb?PGBE|C6N5$-J zJ4a36vgJZyh}zPJ^UahKH!dq3caOhD|DWK3!$OnLs!c| z+P2!N?oDGD>J1ZEM2DRp4d*T${_qAB z$>8>daJ#zzp%>P!Bw8IiW7_60N#Pdl1eLkW|#&tiJ2y3{WVIQb54U=B1{Mollf@ zVJ^XS2n&g&=ab=_%*f$N#h&RTg2(dSXrV%<=n78Vl@Sbg&rpYT1=_+2S-Nb^O#SlH*8oe z=S#zFi7Tf`lbpQ9U$^7)Ldgj%$jO-fw{da2eoR6V_{N3?aE1EguVQOjLN@d*PKnrS zls<o&y;Y;xfe~Z!N+KRKZ)_?BC z*9NZcUB~IGBQN#stHmplbg@o3@93kXMQqEOLSi}=T<=Bdd{>B)VN{jE*9&`hethV+ z+TI)xXGcHJEkNJCAN#ej}rEOx`|IQcO#eL+pmt>*E&gHzg*^>*PZ-2 zomt%wO%tjuNE)oCd6~sgeYvzu1;TgNNrNSG2Y&SeU6ib+vXggJPxt9rS_I47&X3@8 z(+R9=49x*-o39Zc*qnQf2K*K~&$x=Vp2PU#IM-j8MoLTX?*;^jH^9R>kiI_XB!$F+ zD@kUvpmue!&ad|d`;^bpXTSQRd)UX4aYogTnJ#|a+g^^V$eH+mytpmgw@&*LXB-+X zN6E1p5oe9-^WcY~Z`j2PHx+3FD&=)NlHdzRg9AGRG$lDas(|4TS~xp;IGh#5OdHqh zLs2&cox&ln=sL|8M!i}D>c#Z!7`(SW-lT8H-Lx+1_skv2AqBB9a59hjfL15T+*yQ}9xYLtEX*G6afcd)z0hXrd$~hm8aP#mQ={ zpU$gWS&cuN@URqCxwx*;8`a}BaMERvmnX-JyN{WKJI)lN3qDAX5i#hglL>aU9`jlj z%0sT^7y06cxLR0IwgL&ZUp+of$VqN>?jCN0I?#suTBknLH#f7;Zf^fS?Ol5~lxZ7} zv<+#UBL<@>XJJQ)a;_QK$aHdQ3F}l=4Av`^?+wNmH$Zx3vcJ%KsIo zC=ziXzq%NbMRG7db^2m8qhE=Y%5=GX_d-p(%pV5xh3A+|MPNfKV!Td9PyKdNx=O;V zh%EHt+=B{>`~hP9CJP(L>zlI~)S&(-Axvkav=5A@vngQGQpN!D%V??m86BL7GkNSj zO0g*Qkx(?8(DuOr$F$J?WbaznWx1HTLx zZfU3J&)rwt2>V|9wq;$P74g=5x-a><*Ju zUs&_R?nP$RZ_gFG39hDuuuTI|^Cqs}C5M!2mSJ97ODAaGs5$oD*gyTiWf&?w=qj0e z_Jnj^2Mt5DJfLZA{`{Q9$YPI}rq=7gD7F03Uxj~lce#L622)^ zk)U}Ow$W92NF75KsRO#mWu%VGX979L&(J|y0Hui_9EopM9BVzEA_NxyT?37M(~UBK zaKR;HC3a)Oma>!4%~Z?pSV6ce{J)33)PLF4`>sXNZ{%8*@QeLHzf*|ivBJk6=)goKK+F=3 zjG}6W*L8mwH#PNbB&evc#oHK6S>&fFzfmu`{|Yy;12;JxwHyS=;u06@v3K)3ja3K!9du7aq)d$=%c=Sc?;fShbh2{2{S_CmPH5_ zDTE^h}v zopa@m(d`!uGax00yULw#6$(Z*PBz!X_S@$2bn;u(8Nenl@8rEnV87oABeT-Z5XcSg zZGE0WSuk?a*HD#(Z|%Xi_>n$K?liohysQnwZ@VRy`3=^{%qS~eg6$GxWQB_5R)%1h zS%G6v*5C~D5Q3SJeQvo^W1!5)UTQz~CEoJP`N5HQeppE!fC)zwLxs9+>nf~!VQEfT z2NE;97)urF;k+a@{X-eaR>0tSZ*TpF@xl6RUH1n#G57PpK8;mdcz=PFp=E~* zgjs;q^Lp?Tv=YysKcBF>X{P`PhKm)=uWQK5vfF$|-d!v%KBa~gVwG}klq`U1*yiw%R_TGiE zfITE9Up7mFr7h8vhE(L~y}R0K#lDjRb=ua*X?l~(xP5@}?UEwH=JP(?XC-NtGad6* zAO{$N0fSPVH{y(d!zxQ#)u6EN0 zBb0(#ZjMFg$Q~m=Frg z#l2}8P>;o8pm8K}ehgF)w_}w-IH}1N0Sdxc$5c2Udgp41Ytdw9!EBdi3vdEs;baxd zGS4@C1WHr!vmEK!xoYulOAbmHy}Y?rV_LN8s@7dpcMoWtElV~Th>IRt1uh%ez# z5Uk?3V9B5yBP^WX35tAp!8V$usU%O&usHg{0X7FTtUEi`jm+pmI7arTN&T>4gCzOz zL9-L9bwwN(tQ(vI;B{0l&MfPxgOi%p^YePTSZNYpPZ#Uyf|Df{3!e3Kv7Rp0)5T&q ztaR}IQC+ZTm?PObN=bmINP-&dxba(ab5q9JjoSt+W|Ld0`~7GpH)a7yDsv|%r@2wE zs#5Kums=GqXMmxjD#MPdW!V7^%qGbU|Ep_fNt)|r4`Yex$=7zxAtkYk$$8a-RG}mV zBg2`0pN|rm{Up*D1C2Cq&x?U70qW=61g*)n<7#3Cj2z83TMr(+$&gj&dA5ra=+Q6K8d!ged&lcg_-E5Qxr^lSjk+;qm*ZWnc%<$FlNrt%`dd;C>^69qPJ` zXw8Z*JWk=!4%zNU6o&0Dj5j<0FMJUP4`bEs4vytr;o{Z<+a>h@yi}*&Wd38t*i`R3 z+RNmNv(ujWvl^8FB#)E8-F^xC+(cNe4J<1I1f<^r+ZD)QyMWpDCT*86A$yROFI=cI z61jNw8?8~x6pgjLQVyq}A#jD)14J#Cz1O_jogMs(LWXp^rRK$xj4Yk9s&{ zJaY;JkKV}Hwl<4-4dJkOK(+DV#|O!Af)d4=)yD*ksC&R}KfM0mu;~ulSVO9&+#y@| z?t%`m|3jz!0P(#kN|U?+Ra@)~=&Tep*bVY5)h#hYt>wlM!Js4Awyh6!uZw@cbuT>U z!1nx#`29&xk}vsfe*~={*_jyrs?wjd0VNzN`DH07{L&c8EBIo^pMQp@!i~@TdcaCJ zP!bCe($s^|IPN)uBLgj7rz6okyQ6rx6w0#&&dc2@6y8>+yXU@G3c1|b92({X5HpJ& zD6O8!j5lx#vx;^f#i;ivE$oz8Dd(}ZIFl*xnc`azXRSXQ^OXdSf8r#VAaT;r+>AV&(;WGBq2Wb@XROf4OPZ# z(kOiV2yxX+yX(d-DSY_C$l&cXRauo&p`f-kX3{ zr-nV+*QTcQVu4#Ng3^&|YgG;dS_u)~Y+u{0@eH@({5mYx)@mKB|2SC3=5+$K4AGG} R_zmFi@FAOnH_gw){0Dd)t*QV3 literal 0 HcmV?d00001 diff --git a/16/umbraco-cms/customizing/extending-overview/extension-types/entity-actions.md b/16/umbraco-cms/customizing/extending-overview/extension-types/entity-actions.md index 9408aaad8c4..0e0502ca346 100644 --- a/16/umbraco-cms/customizing/extending-overview/extension-types/entity-actions.md +++ b/16/umbraco-cms/customizing/extending-overview/extension-types/entity-actions.md @@ -1,170 +1,174 @@ --- -description: Entity Actions perform an action on a specific item +description: Entity Actions give developers the ability to add custom actions to a fly-out menu. --- # Entity Actions -{% hint style="warning" %} -This page is a work in progress and may undergo further revisions, updates, or amendments. The information contained herein is subject to change without notice. -{% endhint %} - {% hint style="info" %} -Entity Actions was previously called Tree Actions. +**Entity Actions** was previously known as **Tree Actions.** {% endhint %} -Entity Actions is a feature that provides a generic place for secondary or additional functionality for an entity type. An entity type can be a media, document and so on. +Entity Actions is an extension type that provides a fly-out context menu for secondary or additional functionality to an entity (document, media, etc...). -Items in an Umbraco Tree can have associated Actions. The actions visible to the currently logged in user can be controlled via User Permissions. +Developers can define and associate custom actions for entities in a [tree extension](tree.md), workspace, or collection view. Access to these actions can be controlled via user permissions. The Users section of the backoffice allows Administrators to control which actions a user has permissions to access. -You can set a User's permissions for each item in the Umbraco Content tree from the User Section of the Umbraco Backoffice. +## Display Modes -If you are developing a custom section or a custom Dashboard, you might want to display some different options. This depends on a User's permission set on a particular item. +Entity Actions extensions can be displayed in a variety of formats. -## Entity Actions in the UI +### Sidebar Context Menu -
+The sidebar context mode provides a second-level context menu that flies out from the content tree. Backoffice users will typically find default items such as sorting, moving, deleting, and publishing workflow actions here. -

Sidebar Context Menu

+graphic representation of the sidebar context menu - +### Workspace Entity Menu -

Workspace Entity Action Menu

+The workspace entity mode provides a drop-down menu that flies out from the upper decking of a workspace. -
+Workspace Entity Action Menu -
+### Collection Menu -

Collection

+The collection mode provides a drop-down menu that appears above a collection view. - +Collection -

Pickers

+### Picker Menu -
+The picker mode provides a menu in a sidebar modal. -### Sidebar Context Menu +Pickers -Sidebar Context Menu is an entity action that can be performed on a menu item. For example in the content section you can perform some extra actions on the content such as sorting, moving, etc. +## Registering an Entity Action -

Default Entity Action in the Content Section

+To register an entity action, developers declare the entity action in the manifest file, and then extend the `UmbEntityActionBase` class to program the action's behavior. -## Registering an Entity Action +### Declare the Entity Action +{% code title="entity-action/manifest.ts" %} ```typescript import { extensionRegistry } from '@umbraco-cms/extension-registry'; import { MyEntityAction } from './entity-action'; const manifest = { - type: 'entityAction', - alias: 'My.EntityAction', - name: 'My Entity Action', - weight: 10, - api: MyEntityAction, - forEntityTypes: ['my-entity'], - meta: { - icon: 'icon-add', - label: 'My Entity Action', - repositoryAlias: 'My.Repository', - }, + type: 'entityAction', + alias: 'My.EntityAction', + name: 'My Entity Action', + weight: 10, + api: MyEntityAction, + forEntityTypes: ['my-entity'], + meta: { + icon: 'icon-add', + label: 'My Entity Action', + }, }; extensionRegistry.register(manifest); ``` +{% endcode %} -**Default Element** +## The Entity Action Class -```typescript -interface UmbEntityActionElement {} -``` +Umbraco provides a few generic actions that can be used across silos, such as copy, move, trash, etc. Umbraco may include additional generic actions in the future. -### The Entity Action Class +Entity Action extensions will need to supply a class to the extension definition using the `api` property in the manifest file. This class will be instantiated as part of the action and will be passed a reference to the entity that invoked it. -As part of the Extension Manifest you can attach a class that will be instantiated as part of the action. It will have access to the host element, a repository with the given alias and the unique (key etc) of the entity. +The entity action class will provide one of the following methods: +* `getHref` - returns a url that will be used for navigation +* `execute` - programs custom imperative behaviors that can work with contexts and service apis -The class either provides a getHref method, or an execute method. If the getHref method is provided, the action will use the link. Otherwise the `execute` method will be used. When the action is clicked the `execute` method on the api class will be run. When the action is completed, an event on the host element will be dispatched to notify any surrounding elements. +If both methods are provided in the entity action class, the `getHref` method will be preferred. -Example of providing a `getHref` method: +When the action is completed, an event on the host element will be dispatched to notify any surrounding elements. -```typescript -import { UmbEntityActionBase } from '@umbraco-cms/backoffice/entity-action'; -import { UmbControllerHostElement } from '@umbraco-cms/backoffice/controller-api'; -import type { MyRepository } from './my-repository'; - -export class MyEntityAction extends UmbEntityActionBase { - constructor(host: UmbControllerHostElement, repositoryAlias: string, unique: string) { - super(host, repositoryAlias, unique); - } - - async getHref() { - return 'my-link/path-to-something'; - } -} -``` +### The `getHref()` Method -Example of providing a `execute` method: +Entity action extensions are provided `this.args` by the `UmbEntityActionBase` superclass. The `this.args` contains a property, `unique` that allows developers to identity which element the user selected. +The `getHref()` method must return a string value, and the result will be rendered into the DOM as an anchor/link. + +{% code title="entity-action/my-entity-action.ts" %} ```typescript -import { UmbEntityActionBase } from '@umbraco-cms/backoffice/entity-action'; -import { UmbControllerHostElement } from '@umbraco-cms/backoffice/controller-api'; -import type { MyRepository } from './my-repository'; - -export class MyEntityAction extends UmbEntityActionBase { - constructor(host: UmbControllerHostElement, repositoryAlias: string, unique: string) { - super(host, repositoryAlias, unique); - } - - async execute() { - await this.repository.myAction(this.unique); - } +import {UmbEntityActionBase} from '@umbraco-cms/backoffice/entity-action'; + +export class MyEntityAction extends UmbEntityActionBase { + async getHref() { + return `my-link/path-to-something/${this.args.unique}`; + } } ``` +{% endcode %} -If any additional contexts are needed, these can be consumed from the host element: +### The `execute()` Method + +The `execute()` method is flexible and allows developers to perform nearly any task on an entity. Developers can perform network requests using `fetch()`, or access a repository. + +{% hint style="info" %} +The [Executing Requests](../../foundation/fetching-data) article provides an overview of the methods for fetching data from Umbraco, including `tryExecute()` requests. +{% endhint %} +{% code title="entity-action/enable-xgrid-action.ts" %} ```typescript -import { UmbEntityActionBase } from '@umbraco-cms/backoffice/entity-action'; -import { UmbContextConsumerController } from '@umbraco-cms/controller'; -import { UMB_MODAL_SERVICE_CONTEXT } from '@umbraco-cms/modal'; -import { MyRepository } from './my-repository'; +import { + UmbEntityActionBase, +} from "@umbraco-cms/backoffice/entity-action"; + +export class EnableXgridAction extends UmbEntityActionBase { + async execute() { + // perform a network request + // fetch(`/server-resource/${this.args.unique}`) -export class MyEntityAction extends UmbEntityActionBase { - constructor(host: UmbControllerHostElement, repositoryAlias: string, unique: string) { - super(host, repositoryAlias, unique); + // or fetch repository + //const repository = ... - new UmbContextConsumerController(this.host, UMB_MODAL_SERVICE_CONTEXT, (instance) => { - this.#modalService = instance; - }); - } - ... + console.log(this.args.unique); + } } ``` +{% endcode %} -We currently have a couple of generic actions that can be used across silos, so we don't have to write the same logic again. These actions include copy, move, trash, delete, etc. We can add more as we discover the needs. +### Overriding the UmbEntityActionBase Constructor -## User Permission Codes - -Here is a list of the entity actions and associated user permission codes shipped by Umbraco CMS and add-on projects, such as Umbraco Deploy. This list also includes codes used by some community packages. +If additional contexts are needed, they can be consumed from the host element via the `constructor` method. -If you are building a package or adding custom entity actions to your solution, it's important to pick a permission letter. Ensure that it doesn't clash with one of these. - -If you have created a package using a custom entity action, consider providing an update to this documentation page. You can do this via a PR to the [documentation repository](https://github.com/umbraco/UmbracoDocs). This will allow other developers to discover and avoid using the same permission letter. +{% code title="entity-action/link-to-server-services-action.ts" %} +```typescript +import { + UmbEntityActionBase, + UmbEntityActionArgs, +} from "@umbraco-cms/backoffice/entity-action"; +import { UmbControllerHostElement } from "@umbraco-cms/backoffice/controller-api"; +import { UmbContextConsumerController } from '@umbraco-cms/controller'; +import { UMB_MODAL_SERVICE_CONTEXT } from '@umbraco-cms/modal'; -Currently, we allow two extension points on the client for user permissions: +export class LinkToServerServicesAction extends UmbEntityActionBase { + constructor( + host: UmbControllerHostElement, + args: UmbEntityActionArgs, + ) { + super(host, args); -* **Entity User Permissions** - Relates to an entity (example document). + new UmbContextConsumerController(this.host, UMB_MODAL_SERVICE_CONTEXT, (instance) => { + this.#modalService = instance; + }); + } -

Entity User Permissions UI

+ // ... +} +``` +{% endcode %} -* **Granular User Permission** - Relates to a $type server schemaType. +## User Permission Codes -

Granular User Permission UI

+Developers can define custom user permission codes to control access to their actions, in addition to the standard Umbraco user permission codes. Custom permission codes need to be unique and should not clash with existing permission codes. -Each permission comes with a set of verbs, that will be checked against client and server-side. +Each permission has a set of verbs that will be checked against on both the client and server. -The Core currently ships with entity user permission for documents. The permissions are as follows: +### Standard Umbraco Permission Letters -| Current Backoffice Letter | Verb | -| ------------------------- | -------------------------------- | +| Current Backoffice letter | Verb | +|---------------------------|----------------------------------| | C | Umb.Document.Create | | F | Umb.Document.Read | | A | Umb.Document.Update | @@ -182,35 +186,127 @@ The Core currently ships with entity user permission for documents. The permissi | K | Umb.Document.Rollback | | V | Umb.DocumentRecycleBin.Restore | -**Entity User Permissions** will be registered in the extension registry with a manifest with the following type. Example: +### Custom Permission Letters -```typescript +Developers who create packages with custom entity actions are encouraged to update this document by submitting pull requests to the [documentation repository](https://github.com/umbraco/UmbracoDocs). This will inform other developers which permission letters they should avoid defining. + +| Custom Backoffice letter | Verb | +|--------------------------|--------------------------------| +| ⌘ | *Placeholder* | + +## Entity Action Permissions + +Umbraco provides two extension types for user permissions: **entity user permissions** and **granular user permissions.** + +These two extension types are used in tandem with each other. + +* `entityUserPermission`: Defines _what_ can be done and allows assigning them globally to a User Group. +* `userGranularPermission`: Defines _how_ those same verbs can be assigned to specific nodes in the User Management UI. These extension types provide an interactive interface in the backoffice to control permission assignment. + +### Entity User Permissions + +Entity user permissions are assigned to a document, media, member, etc., and are registered using the `entityUserPermission` type in the extension's manifest. + +{% code title="entity-action/manifests.json" %} +```json { - "type": "entityUserPermission", - "alias": "Umb.UserPermission.Document.Rollback", - "name": "Document Rollback User Permission", - "meta": { - "entityType": "document", - "verbs": ["Umb.Document.Rollback"], - "labelKey": "actions_rollback", - "descriptionKey": "actionDescriptions_rollback", - "group": "administration", - }, - }, + "$schema": "../../umbraco-package-schema.json", + "name": "My Package", + "version": "0.1.0", + "extensions": [ + { + "type": "entityUserPermission", + "alias": "My.UserPermission.Document.Archive", + "name": "Document Archive User Permission", + "forEntityTypes": ["document"], + "meta": { + "verbs": ["My.Document.Archive"], + "label": "Archive Document", + "description": "Allow user to archive documents", + "group": "administration" + } + } + ] +} ``` +{% endcode %} -**Granular permissions** will also be registered. It is possible to provide a custom element to build the needed UX for that type of permission: +#### Management Interface -```typescript +The `entityUserPermission` extension type will render a toggle control in the **Default permissions** pane in the Users > User Groups editor. + +

Entity User Permissions UI

+ +### Granular User Permission + +Extension developers can customize the selection and interaction style of a granular permission using the `element` property. The `element` property accepts the file location of a custom web component, and will render that component in the management interface. + +{% code title="entity-action/manifests.json" %} +```json { - "type": "userGranularPermission", - "alias": "Umb.UserGranularPermission.Document", - "name": "Document Granular User Permission", - "element": "element.js", - "meta": { - "schemaType": "DocumentPermissionPresentationModel", - "label": "Documents", - "description": "Assign permissions to specific documents", - }, - }, + "$schema": "../../umbraco-package-schema.json", + "name": "My Package", + "version": "0.1.0", + "extensions": [ + { + "type": "userGranularPermission", + "alias": "Umb.UserGranularPermission.Document", + "name": "Document Granular User Permission", + "element": "element.js", + "meta": { + "schemaType": "DocumentPermissionPresentationModel", + "label": "Documents", + "description": "Assign permissions to specific documents" + } + } + ] +} +``` +{% endcode %} + +#### Management Interface + +The `userGranularPermission` extension type will render a document selection control in the **Granular permissions** pane in the Users > User Groups editor by default. The default selector can be replaced with a custom web component. + +

Default Granular User Permission UI

+ +

Custom Granular User Permission UI

+ +### Enforcing Permissions + +Developers can enforce permission controls on **Entity Action** extensions by defining conditions in the `conditions` array. + +In the following example, the `conditions:alias` property of an `entityAction` extension matches the `alias` property of the `entityUserPermission` extension definition. + +Similarly, the `conditions:config:allOf` array must contain the one of the values from the `meta:verbs` array of the `entityUserPermission` extension definition. + +{% code title="entity-action/manifests.json" %} +```json +{ + "$schema": "../../umbraco-package-schema.json", + "name": "My Package", + "version": "0.1.0", + "extensions": [ + { + "type": "entityAction", + "alias": "My.EntityAction.Archive", + "name": "Archive Document Action", + "forEntityTypes": ["document"], + "api": "...", + "meta": { + "icon": "icon-box", + "label": "Archive" + }, + "conditions": [ + { + "alias": "Umb.Condition.UserPermission.Document", + "config": { + "allOf": ["My.Document.Archive"] + } + } + ] + } + ] +} ``` +{% endcode %} diff --git a/17/umbraco-cms/.gitbook/assets/granular-user-permissions-ui-custom.png b/17/umbraco-cms/.gitbook/assets/granular-user-permissions-ui-custom.png new file mode 100644 index 0000000000000000000000000000000000000000..cbf863e98a0cea4d0ee0023bcb0e94ad522522c3 GIT binary patch literal 127002 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 R_zmFi@FAOnH_gw){0Dd)t*QV3 literal 0 HcmV?d00001 diff --git a/17/umbraco-cms/customizing/extending-overview/extension-types/entity-actions.md b/17/umbraco-cms/customizing/extending-overview/extension-types/entity-actions.md index 9408aaad8c4..0e0502ca346 100644 --- a/17/umbraco-cms/customizing/extending-overview/extension-types/entity-actions.md +++ b/17/umbraco-cms/customizing/extending-overview/extension-types/entity-actions.md @@ -1,170 +1,174 @@ --- -description: Entity Actions perform an action on a specific item +description: Entity Actions give developers the ability to add custom actions to a fly-out menu. --- # Entity Actions -{% hint style="warning" %} -This page is a work in progress and may undergo further revisions, updates, or amendments. The information contained herein is subject to change without notice. -{% endhint %} - {% hint style="info" %} -Entity Actions was previously called Tree Actions. +**Entity Actions** was previously known as **Tree Actions.** {% endhint %} -Entity Actions is a feature that provides a generic place for secondary or additional functionality for an entity type. An entity type can be a media, document and so on. +Entity Actions is an extension type that provides a fly-out context menu for secondary or additional functionality to an entity (document, media, etc...). -Items in an Umbraco Tree can have associated Actions. The actions visible to the currently logged in user can be controlled via User Permissions. +Developers can define and associate custom actions for entities in a [tree extension](tree.md), workspace, or collection view. Access to these actions can be controlled via user permissions. The Users section of the backoffice allows Administrators to control which actions a user has permissions to access. -You can set a User's permissions for each item in the Umbraco Content tree from the User Section of the Umbraco Backoffice. +## Display Modes -If you are developing a custom section or a custom Dashboard, you might want to display some different options. This depends on a User's permission set on a particular item. +Entity Actions extensions can be displayed in a variety of formats. -## Entity Actions in the UI +### Sidebar Context Menu -
+The sidebar context mode provides a second-level context menu that flies out from the content tree. Backoffice users will typically find default items such as sorting, moving, deleting, and publishing workflow actions here. -

Sidebar Context Menu

+graphic representation of the sidebar context menu - +### Workspace Entity Menu -

Workspace Entity Action Menu

+The workspace entity mode provides a drop-down menu that flies out from the upper decking of a workspace. -
+Workspace Entity Action Menu -
+### Collection Menu -

Collection

+The collection mode provides a drop-down menu that appears above a collection view. - +Collection -

Pickers

+### Picker Menu -
+The picker mode provides a menu in a sidebar modal. -### Sidebar Context Menu +Pickers -Sidebar Context Menu is an entity action that can be performed on a menu item. For example in the content section you can perform some extra actions on the content such as sorting, moving, etc. +## Registering an Entity Action -

Default Entity Action in the Content Section

+To register an entity action, developers declare the entity action in the manifest file, and then extend the `UmbEntityActionBase` class to program the action's behavior. -## Registering an Entity Action +### Declare the Entity Action +{% code title="entity-action/manifest.ts" %} ```typescript import { extensionRegistry } from '@umbraco-cms/extension-registry'; import { MyEntityAction } from './entity-action'; const manifest = { - type: 'entityAction', - alias: 'My.EntityAction', - name: 'My Entity Action', - weight: 10, - api: MyEntityAction, - forEntityTypes: ['my-entity'], - meta: { - icon: 'icon-add', - label: 'My Entity Action', - repositoryAlias: 'My.Repository', - }, + type: 'entityAction', + alias: 'My.EntityAction', + name: 'My Entity Action', + weight: 10, + api: MyEntityAction, + forEntityTypes: ['my-entity'], + meta: { + icon: 'icon-add', + label: 'My Entity Action', + }, }; extensionRegistry.register(manifest); ``` +{% endcode %} -**Default Element** +## The Entity Action Class -```typescript -interface UmbEntityActionElement {} -``` +Umbraco provides a few generic actions that can be used across silos, such as copy, move, trash, etc. Umbraco may include additional generic actions in the future. -### The Entity Action Class +Entity Action extensions will need to supply a class to the extension definition using the `api` property in the manifest file. This class will be instantiated as part of the action and will be passed a reference to the entity that invoked it. -As part of the Extension Manifest you can attach a class that will be instantiated as part of the action. It will have access to the host element, a repository with the given alias and the unique (key etc) of the entity. +The entity action class will provide one of the following methods: +* `getHref` - returns a url that will be used for navigation +* `execute` - programs custom imperative behaviors that can work with contexts and service apis -The class either provides a getHref method, or an execute method. If the getHref method is provided, the action will use the link. Otherwise the `execute` method will be used. When the action is clicked the `execute` method on the api class will be run. When the action is completed, an event on the host element will be dispatched to notify any surrounding elements. +If both methods are provided in the entity action class, the `getHref` method will be preferred. -Example of providing a `getHref` method: +When the action is completed, an event on the host element will be dispatched to notify any surrounding elements. -```typescript -import { UmbEntityActionBase } from '@umbraco-cms/backoffice/entity-action'; -import { UmbControllerHostElement } from '@umbraco-cms/backoffice/controller-api'; -import type { MyRepository } from './my-repository'; - -export class MyEntityAction extends UmbEntityActionBase { - constructor(host: UmbControllerHostElement, repositoryAlias: string, unique: string) { - super(host, repositoryAlias, unique); - } - - async getHref() { - return 'my-link/path-to-something'; - } -} -``` +### The `getHref()` Method -Example of providing a `execute` method: +Entity action extensions are provided `this.args` by the `UmbEntityActionBase` superclass. The `this.args` contains a property, `unique` that allows developers to identity which element the user selected. +The `getHref()` method must return a string value, and the result will be rendered into the DOM as an anchor/link. + +{% code title="entity-action/my-entity-action.ts" %} ```typescript -import { UmbEntityActionBase } from '@umbraco-cms/backoffice/entity-action'; -import { UmbControllerHostElement } from '@umbraco-cms/backoffice/controller-api'; -import type { MyRepository } from './my-repository'; - -export class MyEntityAction extends UmbEntityActionBase { - constructor(host: UmbControllerHostElement, repositoryAlias: string, unique: string) { - super(host, repositoryAlias, unique); - } - - async execute() { - await this.repository.myAction(this.unique); - } +import {UmbEntityActionBase} from '@umbraco-cms/backoffice/entity-action'; + +export class MyEntityAction extends UmbEntityActionBase { + async getHref() { + return `my-link/path-to-something/${this.args.unique}`; + } } ``` +{% endcode %} -If any additional contexts are needed, these can be consumed from the host element: +### The `execute()` Method + +The `execute()` method is flexible and allows developers to perform nearly any task on an entity. Developers can perform network requests using `fetch()`, or access a repository. + +{% hint style="info" %} +The [Executing Requests](../../foundation/fetching-data) article provides an overview of the methods for fetching data from Umbraco, including `tryExecute()` requests. +{% endhint %} +{% code title="entity-action/enable-xgrid-action.ts" %} ```typescript -import { UmbEntityActionBase } from '@umbraco-cms/backoffice/entity-action'; -import { UmbContextConsumerController } from '@umbraco-cms/controller'; -import { UMB_MODAL_SERVICE_CONTEXT } from '@umbraco-cms/modal'; -import { MyRepository } from './my-repository'; +import { + UmbEntityActionBase, +} from "@umbraco-cms/backoffice/entity-action"; + +export class EnableXgridAction extends UmbEntityActionBase { + async execute() { + // perform a network request + // fetch(`/server-resource/${this.args.unique}`) -export class MyEntityAction extends UmbEntityActionBase { - constructor(host: UmbControllerHostElement, repositoryAlias: string, unique: string) { - super(host, repositoryAlias, unique); + // or fetch repository + //const repository = ... - new UmbContextConsumerController(this.host, UMB_MODAL_SERVICE_CONTEXT, (instance) => { - this.#modalService = instance; - }); - } - ... + console.log(this.args.unique); + } } ``` +{% endcode %} -We currently have a couple of generic actions that can be used across silos, so we don't have to write the same logic again. These actions include copy, move, trash, delete, etc. We can add more as we discover the needs. +### Overriding the UmbEntityActionBase Constructor -## User Permission Codes - -Here is a list of the entity actions and associated user permission codes shipped by Umbraco CMS and add-on projects, such as Umbraco Deploy. This list also includes codes used by some community packages. +If additional contexts are needed, they can be consumed from the host element via the `constructor` method. -If you are building a package or adding custom entity actions to your solution, it's important to pick a permission letter. Ensure that it doesn't clash with one of these. - -If you have created a package using a custom entity action, consider providing an update to this documentation page. You can do this via a PR to the [documentation repository](https://github.com/umbraco/UmbracoDocs). This will allow other developers to discover and avoid using the same permission letter. +{% code title="entity-action/link-to-server-services-action.ts" %} +```typescript +import { + UmbEntityActionBase, + UmbEntityActionArgs, +} from "@umbraco-cms/backoffice/entity-action"; +import { UmbControllerHostElement } from "@umbraco-cms/backoffice/controller-api"; +import { UmbContextConsumerController } from '@umbraco-cms/controller'; +import { UMB_MODAL_SERVICE_CONTEXT } from '@umbraco-cms/modal'; -Currently, we allow two extension points on the client for user permissions: +export class LinkToServerServicesAction extends UmbEntityActionBase { + constructor( + host: UmbControllerHostElement, + args: UmbEntityActionArgs, + ) { + super(host, args); -* **Entity User Permissions** - Relates to an entity (example document). + new UmbContextConsumerController(this.host, UMB_MODAL_SERVICE_CONTEXT, (instance) => { + this.#modalService = instance; + }); + } -

Entity User Permissions UI

+ // ... +} +``` +{% endcode %} -* **Granular User Permission** - Relates to a $type server schemaType. +## User Permission Codes -

Granular User Permission UI

+Developers can define custom user permission codes to control access to their actions, in addition to the standard Umbraco user permission codes. Custom permission codes need to be unique and should not clash with existing permission codes. -Each permission comes with a set of verbs, that will be checked against client and server-side. +Each permission has a set of verbs that will be checked against on both the client and server. -The Core currently ships with entity user permission for documents. The permissions are as follows: +### Standard Umbraco Permission Letters -| Current Backoffice Letter | Verb | -| ------------------------- | -------------------------------- | +| Current Backoffice letter | Verb | +|---------------------------|----------------------------------| | C | Umb.Document.Create | | F | Umb.Document.Read | | A | Umb.Document.Update | @@ -182,35 +186,127 @@ The Core currently ships with entity user permission for documents. The permissi | K | Umb.Document.Rollback | | V | Umb.DocumentRecycleBin.Restore | -**Entity User Permissions** will be registered in the extension registry with a manifest with the following type. Example: +### Custom Permission Letters -```typescript +Developers who create packages with custom entity actions are encouraged to update this document by submitting pull requests to the [documentation repository](https://github.com/umbraco/UmbracoDocs). This will inform other developers which permission letters they should avoid defining. + +| Custom Backoffice letter | Verb | +|--------------------------|--------------------------------| +| ⌘ | *Placeholder* | + +## Entity Action Permissions + +Umbraco provides two extension types for user permissions: **entity user permissions** and **granular user permissions.** + +These two extension types are used in tandem with each other. + +* `entityUserPermission`: Defines _what_ can be done and allows assigning them globally to a User Group. +* `userGranularPermission`: Defines _how_ those same verbs can be assigned to specific nodes in the User Management UI. These extension types provide an interactive interface in the backoffice to control permission assignment. + +### Entity User Permissions + +Entity user permissions are assigned to a document, media, member, etc., and are registered using the `entityUserPermission` type in the extension's manifest. + +{% code title="entity-action/manifests.json" %} +```json { - "type": "entityUserPermission", - "alias": "Umb.UserPermission.Document.Rollback", - "name": "Document Rollback User Permission", - "meta": { - "entityType": "document", - "verbs": ["Umb.Document.Rollback"], - "labelKey": "actions_rollback", - "descriptionKey": "actionDescriptions_rollback", - "group": "administration", - }, - }, + "$schema": "../../umbraco-package-schema.json", + "name": "My Package", + "version": "0.1.0", + "extensions": [ + { + "type": "entityUserPermission", + "alias": "My.UserPermission.Document.Archive", + "name": "Document Archive User Permission", + "forEntityTypes": ["document"], + "meta": { + "verbs": ["My.Document.Archive"], + "label": "Archive Document", + "description": "Allow user to archive documents", + "group": "administration" + } + } + ] +} ``` +{% endcode %} -**Granular permissions** will also be registered. It is possible to provide a custom element to build the needed UX for that type of permission: +#### Management Interface -```typescript +The `entityUserPermission` extension type will render a toggle control in the **Default permissions** pane in the Users > User Groups editor. + +

Entity User Permissions UI

+ +### Granular User Permission + +Extension developers can customize the selection and interaction style of a granular permission using the `element` property. The `element` property accepts the file location of a custom web component, and will render that component in the management interface. + +{% code title="entity-action/manifests.json" %} +```json { - "type": "userGranularPermission", - "alias": "Umb.UserGranularPermission.Document", - "name": "Document Granular User Permission", - "element": "element.js", - "meta": { - "schemaType": "DocumentPermissionPresentationModel", - "label": "Documents", - "description": "Assign permissions to specific documents", - }, - }, + "$schema": "../../umbraco-package-schema.json", + "name": "My Package", + "version": "0.1.0", + "extensions": [ + { + "type": "userGranularPermission", + "alias": "Umb.UserGranularPermission.Document", + "name": "Document Granular User Permission", + "element": "element.js", + "meta": { + "schemaType": "DocumentPermissionPresentationModel", + "label": "Documents", + "description": "Assign permissions to specific documents" + } + } + ] +} +``` +{% endcode %} + +#### Management Interface + +The `userGranularPermission` extension type will render a document selection control in the **Granular permissions** pane in the Users > User Groups editor by default. The default selector can be replaced with a custom web component. + +

Default Granular User Permission UI

+ +

Custom Granular User Permission UI

+ +### Enforcing Permissions + +Developers can enforce permission controls on **Entity Action** extensions by defining conditions in the `conditions` array. + +In the following example, the `conditions:alias` property of an `entityAction` extension matches the `alias` property of the `entityUserPermission` extension definition. + +Similarly, the `conditions:config:allOf` array must contain the one of the values from the `meta:verbs` array of the `entityUserPermission` extension definition. + +{% code title="entity-action/manifests.json" %} +```json +{ + "$schema": "../../umbraco-package-schema.json", + "name": "My Package", + "version": "0.1.0", + "extensions": [ + { + "type": "entityAction", + "alias": "My.EntityAction.Archive", + "name": "Archive Document Action", + "forEntityTypes": ["document"], + "api": "...", + "meta": { + "icon": "icon-box", + "label": "Archive" + }, + "conditions": [ + { + "alias": "Umb.Condition.UserPermission.Document", + "config": { + "allOf": ["My.Document.Archive"] + } + } + ] + } + ] +} ``` +{% endcode %}