From 7dd2f1180540931d8d4733e6834c59b9eae3916a Mon Sep 17 00:00:00 2001 From: piinthecloud Date: Wed, 21 Aug 2024 17:56:26 +0200 Subject: [PATCH] Docs/check payment method support (#50845) * Fixed minor issues with recently added snippets docs Fixed a few duplicate titles and encoding issues in the docs that were recently added via public resources. * Create docs-check_payment_method_support * update manifest * fix linter errors --------- Co-authored-by: Yaku <15178758+jacoswan@users.noreply.github.com> --- .../check_payment_method_support.md | 4 +- .../configuring_special_tax_scenarios.md | 14 +- docs/code-snippets/custom-field-value.png | Bin 0 -> 193529 bytes ...arketplace_suggestions_programmatically.md | 5 +- .../free_shipping_customization.md | 6 +- ...kup_advacned_settings_and_customization.md | 10 +- .../making_translations_upgrade_safe.md | 2 - ...hind_load_balanacers_or_reverse_proxies.md | 2 +- .../uninstall_remove_all_woocommerce_data.md | 8 +- ...erver_to_protect_your_uploads_directory.md | 2 - docs/docs-manifest.json | 52 ++--- docs/theme-development/template-structure.md | 218 ++++++++++-------- .../docs-check_payment_method_support | 4 + 13 files changed, 174 insertions(+), 153 deletions(-) create mode 100644 docs/code-snippets/custom-field-value.png create mode 100644 plugins/woocommerce/changelog/docs-check_payment_method_support diff --git a/docs/code-snippets/check_payment_method_support.md b/docs/code-snippets/check_payment_method_support.md index d28fcef8b9a..4b3bce78198 100644 --- a/docs/code-snippets/check_payment_method_support.md +++ b/docs/code-snippets/check_payment_method_support.md @@ -5,8 +5,6 @@ tags: payment-methods current wccom url: https://woocommerce.com/document/check-if-payment-gateway-supports-refunds-subscriptions-preorders/ --- -# Check if a Payment Method Support Refunds, Subscriptions or Pre-orders - If a payment method's documentation doesn’t clearly outline the supported features, you can often find what features are supported by looking at payment methods code. Payment methods can add support for certain features from WooCommerce and its extensions. For example, a payment method can support refunds, subscriptions or pre-orders functionality. @@ -41,4 +39,4 @@ class WC_Gateway_Simplify_Commerce extends WC_Payment_Gateway { ); ``` -If you don’t find `$this->supports` in the plugin files, that may mean that the payment method isn’t correctly declaring support for refunds, subscripts or pre-orders. +If you don't find `$this->supports` in the plugin files, that may mean that the payment method isn't correctly declaring support for refunds, subscripts or pre-orders. diff --git a/docs/code-snippets/configuring_special_tax_scenarios.md b/docs/code-snippets/configuring_special_tax_scenarios.md index 6b3c7e07126..1dc991844d8 100644 --- a/docs/code-snippets/configuring_special_tax_scenarios.md +++ b/docs/code-snippets/configuring_special_tax_scenarios.md @@ -5,15 +5,11 @@ tags: code-snippet, tax current wccom url: https://woocommerce.com/document/setting-up-taxes-in-woocommerce/configuring-specific-tax-setups-in-woocommerce/#configuring-special-tax-setups --- -# Code snippets for configuring special tax scenarios - ## Scenario A: Charge the same price regardless of location and taxes -Scenario A: Charge the same price regardless of location and taxes - If a store enters product prices including taxes, but levies various location-based tax rates, the prices will appear to change depending on which tax rate is applied. In reality, the base price remains the same, but the taxes influence the total. [Follow this link for a detailed explanation](https://woocommerce.com/document/how-taxes-work-in-woocommerce/#cross-border-taxes). -Some merchants prefer to dynamically change product base prices to account for the changes in taxes and so keep the total price consistent regardless of tax rate. Enable that functionality by adding the following snippet to your child theme’s functions.php file or via a code snippet plugin. +Some merchants prefer to dynamically change product base prices to account for the changes in taxes and so keep the total price consistent regardless of tax rate. Enable that functionality by adding the following snippet to your child theme's functions.php file or via a code snippet plugin. ```php L_FzrBL>5>@zA% zB_``IV~k7;#*Ae!7-POKowS_K`#gSs{r)@sQLkRheP8!|UDxwk@40)?++^2|13P$l zcy^sXclHtw&lWWv9=SUo_biL%Q8xsPSHA#EoZ7q@~<3iqDY!c01l>X?wG_Z-(^9 zFK?=NZ1!dCnJLFTesD4dWTbHP<-N6LV$4>m?4mv2R_F{dK}R*e=$K5K(L1$*G;`VR z##`)2lo83NnRv@0vEl@LFL`s#V#@J=*ZJ(9pajb8+ z9k63oui5oVc!R`v;ER{)olWw2J&!#E$+tp+Ug^AVWt?5DQUPV`2tr)S*g3Z6AkXl~ zamCUwmh8b&Gq2+@ZSgjqYS_7$rJ6BOcV0L{(Zfp%|55X~d#s@XBaSjBWSytiZ1W;3 z_mim76g6V?tVkIN9DZo z`M+*0NysF9KC%B$j`Ux0@2sxhyWXkw`)*ZivJCV(v$nG*bd&5QqTo5l<#(jIU_Y)O=kxv%-p@%3?q?HMZ)}aM?}JVR{_1hSTQTr0p(ir{$9)Z=;!8nP zb^D!bTM?ThX+-O4Rodwf);r*J5Qke;VhCb_k>VP5xkpASTw~oU~0iXbozZ4W{;@uNEecFdnl2f*0 z%qzum5c!*ZzoO33>$i1Zzj=M#)M8xZ&L7*aDTf8C7YN6TIo5B%mO`!0dTZ-Xa%~OPM~k+1!uvhwOR%{W7<~^=!#brmy$>X9sN1L*b((1BYnMXv+9^P!; zjXPV^vNvyB^W9m0_-rdI7I;O#>#}X2t=R=FR|r_?+I5JFn^Fk)#`+69Iw4xXCD<+S znsf-**AJ={qAT;|4K3h${kF1<^p{rxeRO4P%`Qrxfdsfot0|pOIw7OCLt0u|C*Zof z)}^z?Uq1)_rz_(b7|FKRWvmKAw|M9~i_ z`}ZIl@z^s4FA0KGC;7f72Q0<^FvpKj_zG0Si=Kf1<3S zbVB*t*ubYc>vy#-xj`YmLF>a`@$(AQJE`;K<$vD(KHJ}4Sp;~w0rakarl<1tlOON> z^Zhdr@QnaBDD=nof4uk4_b+-v0wKU&1190TU!Yq6@bTB#HVFLpH@=RgqrARdKWyLM zy!mn$V2<7n9p!I~*4vSs|NBQC9s{29XALihY?>m47rNPmN-xE0i{8w-s8oM+yFK60 z6qS8vL)v~V+wxIker89!?7f|tyziDbU-)He_x6*@o3_iG$KGi*Hzj$VJAB70HT6)` z_GT~V&!Ad-~WZYZQFcnwr-5{Pa30N0grc% zU3z@<-zJbQ{dDl(=;GTVD_yFRYU=j%pW|+f1}r@M-{|^p;s0^`|H$QkqW(W%=06?( z58VDK7XP98|FEb3nX~`w_&>$sKL_T2I<5bCZvV&k_}hv7&t?5z8}na~@?UiJ&&c;b zU;Up>*?;l)|9^>y8LMq5i{YX0Y5LkMBXR(}UE}0NmZ2$GKqnBlxxU*%AKsQoi<0MG zBW~6ENDAnt*15tYL3S^$xA8AdlkmFqn|Uzh+NBXiebnY}3cb^G7@==RxT89nsY0BV zz=V5b#8iCCdDx~z@nGxv)t+^ixnk>J4GVPM1L99>XK$U2q69(e%88grZtEVuvl~`6 zTJn%|Y1yt6%Zsk!A0_|#>W-8;^Li-gR+f3-viQ?`8L1s2C5ZN;`9cEY%7}?4jCU5H z8F`+lv7`dvaq5z`h1QYw9dHxIfcI=fx)nxj5KeN?LQ(T}5=Hi|jX{|0pM2+L>2= z*KIaERPFn>hlVk`s@L?E2%RN~yAPBg%N27CoW!MqKp$wX)?X7v(ME!T{kDG;IPd-; zbL9IXDo+*lFx+e_6x`SRT;(f!oo#k(^PPI%#(1{S+?NZa;7*jJ+X;VT`%f3qj>iC=$}86=9r?EUpD*6*73|+P z7Iezz`#$`zGC}E5d4R^?Q8!rEPq)7h;+zWP@!mA}xtne9`unplcY>b-G!{2Zng81= zcUl=ZyQbpX3;%7KiUAt?AEl7a|Jy3B0UN!OS@&4=U$&|L5kO=8T)DQ_zpV1ag=pk~ zvC8(JNko|rGwP=gO07iiiExIkOyni9+`ju5z9?W_?gHY-?>vcil%08pX(+3wqhv`B zFl=|&R569L*2u2Am8e^-&7QhNs>oWtcV#nACpS)=baGK^rsfvOR0$o@Kz1iA+MwwR z;G`i=35TOzw}(5i&=>^%w11CoMR>0~NYipP8IK7KL|BFlMPmb*2VpLP+TVH7x6WvD z4bpe|1f}ouvWCJTtgR3Zhv8#_$ui10eN!B}wi3b`z^qA;Y671i_E7Y?@Zv)kPXG`CdfN(Qmfn<#UALX{nIc3DBf=0T?Hw+W(FXGMW?=P|$ z3jKk*rH6QhLSnLwNLj3#R9NEDW0N2lw|lm;;Q8E(*bs1c&Ymo*^aLidZnmU#Ic>QI zt3Q;7-Mr~;QQA2u8X9#x3=gH@}g}% z3_(XQn>8Jm@8HcE{3Zu5A=gsKl_B(WgwInj>F#vEXVK_8A@D1{LVNG#{pQXuR!(m4 z;=4Mzc+cbN2^Fe6K80M(dL@5T6Hb5lJ?q}Tb5qGv!pci)4AY;Cgaf@24 z!D1d<81LMQ%Hx+CQN6tIA~D4&;9c{+xK*u}b{1h5GX9YKF0|sm0$et{f9KG59dm~5 zkcgPNE-kAkbI`)J(2YGO#&sWz;10n_S-RnM=b&+T%O935sBvug%4G)M#+cEMdG{>M zCc5|SX`IXIX6Vmbo#28+L%M`Jq%dm7bAKsG2y1Brb+*u+A(o%U)p6LY60J85ek+4D z?cGWtD@Ua!uzGWymWUjXNiV{cvPi_J>mk}Rf>$`rrw_<Y!u=M>gv~?PMAZ)w1|qAbks>Y%Ia@ zm|GhXCTb-u#)by7Fx<~pyR^aj9TmD%9oVtxP(H*$m#K+`=X_Oso+5(U4w?93klC>> zR}Q=!=Z@c^-n;YeG}c%DQr0N(LEp4@rA4GKHbNq40|T64+X2ikrqO*jrlPB3-cosfPWQv**_=^cQuJsj&o|5wU>vC^~sOa?s(F z^+90Q$)Vk=#U{DzMZJ)rV!{uCb#h&>PI_;Z`6>)M&qyP$#_)61qB@gz!S##J>0&it zCC?7D!t3%Y?oE4LT}I(yFfts*5<@OEHy1o}>A*6yh8($1_5`i_7M;f=w1a&wCsTzj zU{_}+@t+xI9rq4}eNHEZCWa2yAQ~Sp9*dJF&(x{LJ75ZCvrn0Wrccj*H>;&en=E__ z zgv=!w!=ILKIrFq(i`q!gT;mlV%zc1fl7hm(S9%loG>bLBmq0nOiXn4?o@$b&b1`*OaVoN!W z5vyz;40FNGvCc!6`8a01quP`ffslD*>yJ zfNn5P_^QpNi0I%l%&sjx928xKjt|W>*2XBL{9>DE5OI$EvY=#AX6Zf|=ZV#vZgMpS z&xu@8=VGcaoDK!R6WI@e5mrhfCLqKk4k#&$`_0RrMX8RU%twF(eVa1<@C^)70i3Q{ z<8QMgg1R&h8!GlK`eS4Ig)h*2WcPvS=+MoZz(o2GQscq%OgrYgx^Qz^~F>cygXRKkfc5tVD)&Wg=Wn|Sc zsXgRaTIHq`g5Wn=h`$btixc^#OE*B-Nc64ITB@sfPkxXkh($yZYe7^I<~?v<1fecT zclEq8op*NrwO`21PYouzVRVhK?@n$%&pI^moISH~D>$vG&}a=+OxhE-?RXEkfJNyK zaw?F-bX>{WK+Z2xCF%gUf@LL%0~;ESx{|$x&s*<^st;z1$WyvCqnepUU4p}(BEQ4J z`Us*HO$GU)(`l(fU**O58en3dj=A0}pqr#`+gC}~TbQtbRS(YBGTuILsHey=#u+uV z4n|?4hcT1UG_ch~${EpmN@;vCvnukkHP;jC!^#2cIysOT)cz`q!3RWba!~3#FUlWu)2L4s|$XP6I8|24(?& z-(9zkqjz~sB$WwxPVhl6oQwb=Jw3jIDS+wGEh00=U$!)=xf_2~xqh{1HRp?RmuOET zsyM(Brj$63Z0_9@+252;F>5o4qL3SBj2!vS5)^rVp<7cs`>NRkFl(f*?BVbJ!uq(s z05MDVr$O4BhFq68IHi!?@rCI%4-ls#cL1>d_BglR;FI%l4(# zRu{)T6&nta!aW1W)x`5vY|YMXJLh{F8FOUDF7LA^DCP1_-MX{e_0!K>cqY`OvHI$b zuv?k1n}^Q)2S$o=o#$mdY%usBeN6{$En&Oq8_29*C_IdkQxlyGNZq-?+*v+?+yMed zEkw{m@YP*3-a;~L_6b8ba&G8_Vf=XbLpxr9VkN#XkzfZc4AL~#o(|S0 z{(mXlA-)w+4$;}Lo{Vsi&Fbri^{oXVaTTDMK@m8uTM`cau)C@_lj_aZyz}s9j4>U~ z6ZO$@->_rSr7^rhd~c-i$kf;s1YIABf_Qgsi z_HfD4BZeI=!ksmy0&|~(ZU^d0PC~Q!*ZJ%SwqB3#L9#=^Ya#j zwLjSRtEvHF;0}0*AG$0z5+ME0dBM)vyLkCbiAUc1VL0IrF8Ka!w5KIF!LT>+Qpo%Q zZD8`HcXZA)C&|)T7G34vH*`vFGJzDNlOEr#g-wG{YYA&129G6=2}Yx8BGF5?OM9%jRG<}H>mHTTI!4a%|-~#$$0NscQ4~_>mw=--;JlE zc@s9g7+dG)#fdv=M+L1)zy}vg|18u<7v_eXEESUCO`Ha=4ky&Nf+txTBQNg3Ju*~_ z<7_NjL`zCvS_GUO2;F*6_?>3~^dnCn<*w&D-Aac_gkr2c+8tr;p?7$>`N8 zQXD8OKYY&WAhqf;G2)4AwvdJQx_gv=H&1oM{)gyi9@zW&7e~Lr?7rZ%NH+QS&KxEJ-LSz%ZpTuKD#dD@klBvpIOh(6#Um2uREY9mjq>s|B# zEoUApjpVK|Uiu6T=uY$FSdxG8*EP@nYJD}SM$JF|2T9A_9^&Gfb}!&70yHU!#qbzx zIdKwv-a9=%j>AN*Kpo*Nmm7>H=@@20G2A{!vH-$01+5W9q$Cn;tXq7FCi^-{Itq#$ zz?cMiOa=eQ6%!{|WkpF@#kVc&f4m;QKgRdkZP;vcyX;*&%~3)p@*Rjr7D0jIEslIr zlZ(sBgI%0~1w8(#r5?KW0WnFrMp?>j793yQFcEL3YYqw?|ENKB4?xfxo;voqA$u1q zGXIa}uID>NeSX&tS0ig8SRHzX9$)onr_=Bz{k6_!&9gk&$`>z+SAmC^3@$-(ZTJ)6 z`a}Ksku#0tPEYZJjr4jFkvw4cb#%{H#Yd=|l!KXnM7B4n2oXNK2<*lio}=oj&58d+yoT*+NIHPpVrPk)O{ zw5q^oVR3r*Zu*+{X6)8C%J7!wjuEaokU0Dmx;CYdG5iX;o+_SB7z)1bO(f{^9!YVW zO%ovx)yqlt-P>XtmWv<`LW8z#8gOR(8n3vIWl!>tnChSm1WyhS#y2!E+zzn8 zF9?I4d@)wR5k}5bn39{9C`0&5Zs~Sjd?&KPKS8Ze-!(YTcOkd2>$rALt+5>mLUo{( zWB$Q%izZ=lhX^wrAbC8zku)x}b5^wQy&$f0lMg&Rj4Q^V>lrhjYLP=Rd*U(UALHtU z$y{ouy822&uU>5@Y!Hp8c&}5YVrud|m;i7X1p<7{xRU6mR?%D95`Ww0QupYcz?p!X z!TMW@-BgiV>GJHJJbluaguJYYA3XtCBE6 zq$0n8Uaz;!^UJQh4|rWwylY<%hoH2AVrx2q2x5aFjN7;gB~BHH?xUx&XrIuno%-8P zUQfR@An)K&*o}>`Tz2%daCaKdKN_9#=ru~WN5TUJ(HsJLtOERO|DcA?^y3@|q!~f- z#)K87;TEgF|JVO#0Nu4^Cg>W4n@#O3U9a`VoFWQYWq@Zm3tb5P;dFNrZS$ z>Xj7NO86v#j-;O|3R0C?2*Qkc^!8H5RG$5)+tQ^=fF~Xo8UNw_*D*>JdG||uZswsQ zGOvOh6Re0v=#qv-2+hZ_9cv2=Vp9;evZ!I{{teRqmJAUkOi05WLFi$qX z$_sT2y#LrSTv7+3%A(J$PAG^eA(tq(A&+08zG%7_khNd)ao(~qfZ?|5JkoLwEFZl| zA_uK!*N1}K5(z47&uI{tc^wa?IW$2t^L(B#j1bM-wPq%FEyM#x@C#9=egV=m8zOoU2DFyrBXYn7|F*q$} zN*pnVP}`@pvC~7La-;YDCNNs^@Jy5x*K;I7=G?{2Lc)(6N-M5lag;$Qfm1zP$k1*E z1gjQevXRF4Td=G}W|~`Ho;~m_B(FBu<(=_9Nw5mip63U$>*=L<5YxC9bHieX=^aPQu|I z#QZZvAs)YPq14l4cp;yJJCBOKg+^6Dh-ebdU$!VH=pL$g(ayp#3#y#}{|Q*W7}A!y zgWrM)Ae^!t*Y}_P9O!-jkT=2L3<*L+u?rSTTt^jFT0OB|f1@8ohhO#5nIB1tZV{^? zTO^}ekYgQ>Kfw~njZpK}#~aMrmQmgWFjaF@W#`}A{3;2gUjb*E6j+rh|I_|_`%G|O z4X{&9%Gnb?>Bk1R00w}xUQtLdMnQj4-XBKW45;zGCH~VtFMK0#1*}mzAQ-{jy}`vl z$^UmUoreKU*o=wF-3SQ2fBW}K!ASs(eszS7N8joCfdIa3JFfy*Ff8_Qena;DF;kNt zkkIHivmw_0q(k3Fi;flm3WTe?X?j16`+b}G%>WwfC%m<7eq!%;N>AJXEJ!rSpj+11fr3B zHINRdDC&e9{7*q!%bL!l?n32Cc33%!ax z@GvH-SrV4%8{RjR^eSdtcvI|7>t+Nwne$YM?LM%_JY!!_=*RsYfmFS@49m532lh*K zl=Mui=Kteg&FF>X^}wh5avXK|{qX^%(!4uO))?uI zAcJeCIy5&6s042jpY-3Yplc{Z1S-776X?c0jNLkn>vnwN0dd)9bb5uTe>r4WfrUq_ z6tX_VG`$D<5+=~W^RyhE-}y|?3q?7a&0R_29`~psuaZJmC{)BJs>!Patp2P=eI$JB zOe@%J+XZ34{?sEm8BHz%XPqhdNP79*^9W|T+~zsq+rb++%BQxjA8*ck>^WMhLNoz( zs@}v|qRDp0xrkBINNsza1e-0AngKr3kUlIgjQo1hzPTgv{c_G&*^;C~gVRw25$#v@ zF|*`A?A*3z8Oz!4$hqkC1lFy?fN8+n>@~Xa>q<{~r_aOWTgtP?pKlwvhkCwh+&Ged zpt{5-mVec@bPqGa$O=ApXzY^Mtm`IyR7k)fF(&ko{(ITd`^C$Xc}Ek=aN0AeZxa$! z-z#uC@#sDiw4P9BpHZoceRcu3o`Bf(M-`a4f>mAZ=!7IX1qG2ly%FA&FrH*Qpr17r zLmq<9@mq+KtoCS94Xn>^zW^Nmxp1TZ(20G3R=&D=T=*+^1!n_DA_}?;1UFmAcizN{ z%BP5WbCMZq!_(zw#v0YM=yUPW?*%cL2jk|;7U1F8sG_*es)jMwLv>p=pWG%0o`k%{ zySDO%ttLnE2?iX}y(P9#JxePrFS*2(Tl;!IUCExr-*dlITSGT-JXto3A~#Nbf0E ziyUEdb;8P}LHNBT-m!8!6O`aSPY-xtcAED<&8Kz9p5oMuO>qqj|8^7VL8jC0*Jm#} zx73OxML1qL7&!j@BVFpw<7de?e5yP9RZr~QqWKBZh3$GNTx$|aZPo=U_;((jhjCEKi-uyJve(Rak3+1hI>+I{yn0L1oYRI zg%>XvXH5WYL&T?>clVUYMS3$i6eC3p|g>N&NiELaRTigBn zH*8kB3`pY{O&h5T&aOc@PpWG^al;~6clEipumO>hiG!SHdAm4)D7Urc^r>Z)VXeDY zbrNqgZFk-)S`&=`*9*_-H!#CAmb9Isbg%FpY*7(zmqMtuV{&cBfOQZ9{J9eVBQu`9A?xd(EtSwRBlvAY31C;wh{{FhBB z+mz<{MU27js}DBCdl{zhcQm;|$u!KbImF&@4t{#PD}x( z(3lyo$Cf0qbwmhvXenpZpL@Mjw%$$f7)v%j%H(Q6NTxMkyUa&RP`n6!)X+oMIj|T_ zvK$R|a&mSJ!OsINCyccbVdOr329x}5ITn3jTVkY~&f07uy(9bsMQ!R=*=+yyWbl{l ztO^ncrR&J`D|_m?Eilu)@s!^mn+XH1UT)`s)UURs^d+DcFVBh-0miuMih(Ob#5n6| zs`1Fv-0u1kk^b>o1BwkrfrEl7@S);r%Wk9#Y}O^27%hu0mE90@fLE{OXD`c&`a|3J zDXT^7KczyNU-KEiKH>yTI)dcTxGIReNYD-Gj$?XG8F53Q32?6i&Ag_ocb2?~p3&i< zLN!~q$si4r_sJp!V0@z<3PMD<%%v$)?7_(Lnyq|-S@v(Gs?tUh@{A9(LM+v9H+ zEmNraPV*&_ed#5e?(CDjwOuuS4p5HJda`=!JL`h#cu{)lfI9U)djO^D^rFPcPQnkg z{GJ@o-G4VyZ%$jX^T_n$12b<8OcEa8)fXwq1ykkv9_%||k3XLSElxGr`#&u8o9Jl? zT~75_ob|4YWSin>8(k5&Za43Ac_&U9nn_7=-hA?NyOX&{Ai8)wq1DajOviRVx9ucJ>I!1Y|4vu+}C2(uGF2xh?x3I4YE+Ox5gYXVXB>19ULEata?jAuW1q7^t!SXMPEV@ zcBJYM$)HZgR@mUFFpo=z^=bZep+Of#-)a(}!vf z3CBk!lV_6EVTn#VY>R{9YIPX?iFCRs#fgQch0*rC55 zniJmx9wT&n#B6R-311Aku*gAyhitVYpsZ#u*fdyIpu22eO5Eb|bwh>W*5ByupqkKz z6E+t4TO{VxJ1Oc9m<#e{p2)bh*}6Mb4FQL7hk)OYxOwBAT_jXj6bUud=(0e3zSEh( z#XZOW*@Bam3e655x{Z@kK0&pG$GxvsRQ#=v*&%I~1yedZHgf$T)x|A$K#k^NI1)N4 zzI*occ{Fc6!eba{+aViCyOO&+j*N(C=&!EPNqcC{rg6;++C1zIt>yG5v&Wy@c#q#@ zgy|2s)&M!AL%fHDv?lOR9N_a5gA#|E#zV|LN)tW<-8OB;!dF*ZTQq_WHH_t)Q95m5 z3jH{hLNAXv=IGyWDH*ERZc<_t-Zy|NG|Guc#rvePEgvsm@S!TiRYKbEr7b#GXgf3C zi>NuN7A}C-G4D8>_;_sKNSA^SaSYLi*RvC&^hF%ZOZMQ}r??HMv)F{5axK5)YIq7( zLU#fvY&Q7Lo;Djgg{zy16nDhpR#_H_=mDWkg9pYxV9rpgP6-*X(%$eMGj&elN0-g- z$|T!|{U(FXsjzfdtyne1!Tn(4Eq~VG(G%5u^DFuFj5?pm(<9Tnh<)47-hV+Na1Z*@ z=-*-?-wdGAr`8cr`~XP0h;?TlXn{;(T`nsGkXM&+32Rt&C;plB<}R(otCtg6#;^X7 z7#qLCuQ_$U@7rMmfmA8K4)U)MjMV*-z?D~$a$FD1#Zw^cdz-wT@()xi(Pi&vXd5Zr z&l#HsA{@OG#<0IZe8fh}dRvBf@?E!EvLL>m0eUp9h+$M6$u^mWsZ(OyiUV%T`bBmi z%>K@`G5BKqX^xK_BJt2oxiZ_#xZ$dH&re~YmX&DHmnhBW5ejIvxMIre*o%U=>Q4XA zYcL(-q<2jQTU4HEb(AsiqW)%^fimh9Jt*IZl1 zVG2fi@9d8%D#^He`(w&lYXMPcYR^?5Pa7Ay39>erQg=of6EgOBvis5UXUA1GqEA`B zXA=c;c!)W~Dx46Ppk@)dzn{18y*yC#F5Jb{Cqwe~S3~tt4hU!UMBMoLqy-J*VU5hm zPM><>);Lj>1{HBr3kPBD~ z1V!fkn`%hg?YJdtBlM2rPQ8_@qAx8|7FQ{$RmXopZTuEM0gxul@R=T=cJVA%ws^am z6-_(bD2^-cEF&eB6Oc3u3t)S6W-u7PNCVg3DPta-);3O%#LFO_nypqk6iGQ&w`PO& zhd_0?`c8xw(f!-_^q*;eY)Nte`n0w<67i|=*!zbJoX_x&oR7CNj9)sO474hquLfGf zA7kUmliU$8Gyy(Ik(%BeIWrTBnk9p|jN8hSBSc@^T8n^94@=~1R0X7v+Bm!nZ+`^- zYhC%a_kC+P(Oge`%JmqlGMihC&ntCkOo!uD<=3d?Xv9&EmA9jKi58y}8J_zNO47zF zKzm^5syJd<@vd)*7hL!J!_l&nGlFiaOCMSGH8x?7br?mB-@EIAbP%x8)S0S< zO+xFX+-O59jDm*5+}_@~c62pCxUIHo)M}CGlzK^bx6HHfbaxEerxPYwu8`<}Z7cI8 zpyKKXc?l__0~m-o1tV5&X>lM@tjgkfZzL|nC1)#m>)uco*D|G%^=^JK^e{g~?ld%b zHqfY{e6E}vvG8(J{FGHU&;(G$^&gE?cTcZwSO5dP#aWy`&Q*f3cS9SeJ|2?VZShv| zf^J#a?f%_HU-K89d^%;FQT>NYt)s=9=1fWW1O$AQSSjQgGAWECaEPF=p`~79OHrxY za8_if4W5(2PPqRnW~cd}ja62btLwshYsyWPuam}4XnVd>IMywjnqNct}CRVh4YqE2rq(<(MkyEuYKt6%S3orY-} zTf`P0#P8$3;*znXXX2ZOM9=r5``lM{qyh&FQin^=thZM^p^@SEDo0K{ zA%xST3<~TV?=_y~#D)AKiza{613xfnb2e%a4+VOCbMOh*9iPpS3cXd-puVfSA2NTCd za9eDEzq)Uju!K0{3zu3>xLpvE5>}tBI(c#JEkyHPR;%qw z(NO1a19MMZ5VxM5mU1KJ2@+P?2O(mnL{8Y0T~HOtd)bc62b5+gC}wJ&#XOij8scLH z9E$nnkJP%ijeX};>CkAk?yHqWUP@EO>1s&!+RlWD?+E45&<&pvrxUZN1uRH1j8iB zD+nA47GIuk53bc$Y}Xsm>sFXHtuRZl1Gu|lPQ=Y!$f0|hmJF6mbOps>$h7K|m9t zMk@5fx_CzC#5URU$wWQCJnuzdWRTf0O-8qJ7yy}79!YU|65vNwesAcvTuT62Nh${avEpCmJ%WS2cXI36$ z5L6~uPv}Fn@ehxu2-H3vvmMAowbzAq1Ga6xfZ`si8w`S@+9+d)T)QmF^)zhTN}7AR zTD%(Et*RlRI~`Ku#b9wN$bD7p#;vv<*M?jljQPL6I5ChrA!J6Zs{;{7OYM^BfZTfG zQ*euq`+|YJL#u_ZUhpA)@HhYtxObs~?CqtaB4)995j?B=D^Pz(mlHI+Q`ZtnTt6St z`*c@3R{pu~o4r7&{lftqZ4)5Ird~DmC~xOoI3I_;oo72`U#2SXS6LH$c#1>PHQg1t z#35oWcrHZXuf4zp>qVE1NbLQfctX)xr6__CU2#oG0gF&l^Kd-x`k;!1xa!y4H~Q4q z;UGJx5GYfgRQyv)dC{F~4?DgbR;U#`<^z|IYa_b$0WQRxow{QCBKQDyT)xeppn090 zF9o5iwsS62T&qWpwv*NEB7XM@FC67m#+ET9h^KYktM1kTdYe2NQVZ%v0|nY{iRxT9 zm{4wqjj8hmF+=a=i*rtCQB_}*JgsAPXuF_Arji#33d^Z7ZbOcjlr80d9@jpo%7L4uwg+zYEmDxKkw$Z7SQ@2nVN=(S-$14 zP-m?namkS7L|@^0ddPrY*9SaWmHS2;qaL>FnqrcifisjpVQ7&g zvNfa`r{n!)`NMa2u{PQ#ox_2WDGE>SgylEgjr4UA=~7y44Ci)uNQw0H$Fg5Z=%yz@jcFA5l zA1tdCxz6|YqKmxND|w4{L+aLjZh&%|11$$i#D(XUef5ftKr3)sWQv07)!FHkp$?#I z(0??#o;$H*yvr>^@(3W=lEH?VyZ^4_oY06ampNHen|>ntw#b)rf@7j_ARh#;Ebh42 zR@owf82JN@4Cnr^X=-!S)dmi`IX)QLOVK*ozPS6iU8--reVXg_`o~nK5<3o6UCYhU z%wxA&<4N8StLcTsq4yLssbZGiTW0&|x;&$H4?DmEWrEXO-9i~2X`|pYD^Od%rty6H z?5XxyZ^w34RRP=^jf%&o5BlTZ8<>EVEuxxUY?shrlMD9^qlgI#j~r{BMpTOq!dWB| zC}Kp|Q71Fv^E7%uvYr;gx~0vSJQ&zF3@ia5|vgNDu%9S2k5Mljd1 zw`^2%3oQW<1Q@3pu_+;Lr@)9&oj7RQue8 z3Wct#+3lxS@DbWW!PBgEMX`#CVzUZ_qF08;!ldr>jcFobZV*>lf|GEwx^SQ|{Pc6sI7Orm!2S|g(YtD^*?{>~lO=TaHM zk!xlCL^5V9lLQ=gJ2h1D*!Cj#}ydeeeNa=z6ZB4Z-YPKkCIO7;L&4 zAw0U#4>e1EAb$sxhNog~nBw83w4sK}p$u6z4q}A4bmPXm&o2+B2NU1Rsrjvk>^{ZI zZ<458=D#k6uOe3-<^`1?79z(xB3FdjVc%MYb~*uknMwJ$UEyYvZXO9!Pi-z^te36o zxob9&nrnTnbz|0I89oTdTaV0Zmr{*_HkFT6IFfnYL1bU4pvREzsdWn#bT7kd@r5Xu z?OU;H;)BufG3H~@osX^c+)@WxuI+WOH#21u?rA0KmqQx2Jg;+ys%W+aY|;P{Ri}xW z-f5I#SVrhdNwAWglvje7m!I81c9jk-FLxRDx-!rkYgYKSc3x73CgbR4`se)bZw3MhKX^=6`h#_2GMecow*G&6X2PC?zH==dT)1Ck;`U19Vq z(^v5gvf0q_Q85^$Rp%`~iiJM5La-u8Za|0rMI(Hmo3!s5#e=DJmF9cpWb z9y%fRoVw4A!CxYwjs4Iv*$+v?Gw|pKICK>d2Z1M-I&&A_)mBnGLZ8{$uzSnjQW1ca z;~mT6Ka=|iId|-tV|r^7*lvnyQG`2xojnLLcNMB8l`Dva}lR=8#IO$ijDx7S;n_+79n$Hag%%8Yb9I%oW@$TJkzJ?@FI= zPk#&rucF4j8()o?g_#7aE?rL4hv?nB-&d+PL=;^ z@wCOxM{%~ox8d4BWhW=|6ap54+HY6tSUc*_e8>*gi8jnyTTSpLRib%_bv6Ot=TBf zC#T@SSj#YqAl6hVkte{3QroEdMqcZ++u#zTME&kZz zqs-Sm-Ib6Sbe%#Qtutlu(P-7npoLUBq+6BaXQE5pNhN$OZ=VCfq7EM@vP@opdr5{@Ma+}4i{Mq4>oJ6DeFQ|+ zY~K}-?n$KAPTLaf!_7S{2w>ce8II3^mWGO3aq?0uYo4!VbqNOr?`0d5soCUQE_ zJWO$!qp_0)PnVP_LRUp>Th0j20%bxSfYvpX>9RNea*>aEv5n*@7E{X@=ny?kBb+Ao zZm)71kRt#!5>$JBDK&8_oJ}XM_k1*WnUHYf9Xe3Bzzy9u@-hb5CemmtAptC%7v5lf z3=uuL{%Z-6!h@cXhvYO|%GRotBk8e53p*tm=KnIajyUByzw6I93zycXt8OKAzPCX= ztx3vo@=J{Y=z_j$8D@IowikIWM(+4XSSt=Vie3{wOWhr0b9L>#2$>QC`P|4#B-fA8 z>h=T0-U7_}fus2>559*oGkq+@M@vV;fL|y+J#xj7J26>cli|asZm!x?x$>y%=0@#N zmDkCrO0^@QT!3$+v3XhFVQY%sNsX0|5T&`I;I$zCn$NDY@}j5!l|soQG@s>4R8{*~ zv;?H(rnh5AVO(jb(?E5f+0LP<>lg`jwnv3M(rw^Kw?c_mf(?)dREa=nHMYd;A(lEQLLH%?OUVLlIssIf;!ZcKTggWm=Rttu3FtwAqi$J;#Y z=;F((FR(9|whu~Jc4GyO$wlKen*8Fy`lAh};-N38kGgT?o+-W)@B}4?b#}+I*sD9i0+kNk7vF~xIz)%$;)CS4$gtG_3f?|WLJ zfPK3H#2PQ?Co%SEaH<*2%N=R2)`1U~pPLX_Miu`*vfewM&9?m?zgt>u6)kELEvmFA zY7W@ zsOGw6nDX%GT@paevbWifLGAq2?6t;;qvG!~5cl4s)-rqC;236N7P9xKuQMP zG7qv0<{RxpU9P%DiKY>i_D2--PHHum51Y@?^bWcRIAYnb43}ezzYz>9=^OuvchI#6 z?C81GB{9pV^|aWsv``(52x=ZR)A$NuD#?Zi@nIGe(zRh`JC`!cm722?zJei@FNOlA z3i>Jq0a*K{xiWCJ(a@xiL(P13h4Z#@4qn1b(_n%YF-G#*==BUyC~O!!bHLWv&tROp zlcwEM?V1-3DzB19%Of(j7WiK;v}?TIL+LNLr?{)hWSsS2lxHt1OyGNch)RZhJZ@)= z053B+?V?Mi`a%}Ha0&Qe?KHCYgOG=+J zIIuJvYc6#f;LjjI1G{kw*qNGDw^Rm@eygav3GmV=25=wg(WM7g!LLOqzkBnV3~16F z-B)ow))DL8^BLzxyGv$kuEl zLY2cBrRSXM&o+EG*F6?4;zhg{5I^=B;Vl*ETwgft_n(&j3YI*K=DulxmN%rm1a8}?<06C9ZiyVDjmFv=OU`PZ%-aRI(ILg8+s*b z4jjUJ0M$rmCf6a8LYv+McgHZR`&C=(df^VU;|DhL)xLu{la|wSo0Lr_#)GKTQ|E=D zq)Cjh`*xkhh`T;E)$yc<*T$=)&nd5_=vbudSp+(QYqWnIjEJ{PQI=<{TZ4M5puiQ@ z@@fIVSYfM4%b8@nL0JVq*)GchYi9(}N!)cm5qyW|6!XjJ1;-kb4qiy}ra9;<^awkO z#RO&JH6F1JoY_1FSzjLLxBHS^UP}fg{)FQsNFL!2i1ubh0iaAY^wt`Ti>d;7ktY;+ zli^_Ywpv*mNjaCv*dTK zFSl9`lKa?$zOmCz^3_Fno3Y$vZ9U#XDEG6uFEmr?hV6Y!-J$|jOEr2PZmbP~H?@K% z|6}bg!4vtjy?cMe-ZJCC6C;4fKxZ9Wl;K&gY^8F0;hN6W>XLEZ2s7H^;$X?dM30mX zX9JFdUph~Bh+`t7m#gtAVm!Wrh#dl*9;fAV5AowwxZq_~j+ELDhScA4Y?~x4>O+=9 z-FHmTH7f3d7=0nG46qG2zJx=iZ}jH^PxO$F_-Jw8tHue;T$u&FU9-|eyS2t6e5*sa zdbiZL=mm5gV$VaW7m(3=BBxH+8F#~afh0{>9$J-usKPC=78wtBx<(OIcIA`LQ+1jE zt0O#qW_}GSEkrY@^i$ne(2`mSJ!fP~621=}z38d6Pll&FgLPRz_xVA`_=*4e(t#Anx6g( zIf)7i4q25&Qt*UKN{V5v=eSIzMx=V4Rx;7q8Y@9;GTNp(?iY)+j zKu$t@?P_*q1wj*V}O{4q1xS7)i1`xtjF+8#C!5?s($ooAB6pU>uT?#l(fbA|*k@ z+-HHip}EL5z>H%D+^_v|lW3v!vD)1qeX$vb_5G1!*TUVwviS2}ol6JV*lVe$PFzXd zAH4mXy%BO!b_MUaEKb8;m1Phh$yY+hFjy1(B-e3aXN-RbK83~nXA*x=iLcvFOc-70 z!`njkuFz*fB};x$OprehbC8v3SVCuihX&~v$*XF}-@4p|DvXlU=xnLTG(6O6_F-2Z zjMt=&Je^&AVrUbFztqo+IyXa#O5QdjL)gDTT>%X*S}kvfUEmzr@6m{E-j?m%%WrVcc8RUR$yUM$zsNqzGn56M&Z#{L8su ze=XU6>KQ!WaC2EF@QCY2O}>PMsQ^`{v+0Y*qn$eG2tQj9D7`f|;YU3to>TsaUzK3e zRC^c6*^gfMCpg|>R^W#wH7=RAa=yCS8tCJJr)!%hbKi2MNF0XFG`=)M*O(eC;0G>L zj~a2D^7A3kI3{@rv+%0;cgX@E*L0!Ji!rBg0i}_SO^V+wvYZ92i$57?ut;_*f_fvt zygSB;+Q6YHv7aiUGRfz{t^JmbGa?Aocf24cyeb}*051Z^;}QB7qh~!n{C!on|BURA z=|eEfCkK|-9}Wo3G{kN)0M0u|a>&AmFt_FVfj1diFKrXtczibdsMa36$8Wm9Z}_X@ z7|!Q&peOVi*7Ff^jlAA?RYK#q0Bv*Zz}r8AN0xyz1$!yQ!WFq+1iOzqQyeyJ^TPi% zV!gbBPsvh-Ph$;T{Usz@9FMBy@Sw&~k^EYQgONFEQ@~BCIDe<0fIDvWx5 zO!M@^ROcNXw4NkCNzr8WW)y-ilt05duI5xRuB5Tk2`#!RP>kh$9d8NaDZ#rZ*W*Ad z2bJQ`M_~8E_;tqh#B+tQ$Gt@w_~BuPdI!{3*=?EOJ~y>DTZyMYpTe#1#+}jpmaD^s z@anayzT!%|s^9FK+DX!|u*+zu_^jjLE1@-e2=^)smd5b zb+kH#gkku_H+m{{%??%RQ&t4eQruD_ZuBe|pQ(a*>c1$Fns+soG_TMdT`!@zwlv$8cm13u!B-N!Hc%r26l zQk5#Ci7wqZJ4yRi`;49BSL*=lOPN^1i!k5Xkc&L~V_zGX#D{d9+N4?luCkO7&c`(EKl=Z!ckx3&ZV>09FY?ag^RKnF)#JWiIm_11jris3}9yPDE@SQnO|gzJxH?F z{mOjvouvDZata*o(oUm#Dd0gcCl_rYr^2;u`TbJHHqmwFEu%R z^mJ)_XI!OtzK|lyOGc_ma^!49wK<6G%Nll2xCo0NgXpRe%i?!kguZUxTJNoEfi-RB zweCWe1ro|Uchu4>eFK&g(tQrG^fkU>==?+T&W{6FJVum8eMwn7ZDx@d&Qb5*CstE@)A;w#mhw} zI^iAbdgXL!GTimYsT$mI$6E6`?;oABzYNrltnoWsRcU)kf^Im?0?%87jI$D8R;*t0fX+l{l!u36++lM(XCc`<}u194e< z`2_fu7t)D3ybBk4DL7gP9&H4_AA7M5`%B?6d#o6u=Ya=<`nH87*8i9@TN+kKB~7|K zEIYrQR%rUKbZW$0Uae?~&p0f%u06^}sz>}x7vFZ_E-!Q=sOG$%J_s{!_%NvnHqqc7 ztO@gKh)UqXu8qd8LXHM5cj`qJoRh=6+)6dH*8y(R+>H~pJCNEU`%1g>C|kuDP?_Ll zKgMPRqt(=3W}QdikV@rr&uMp43vDaj(ooi34Z;T|MPYrq(kNXg@;&yWUgSJN5dIVQ zaV1|ug+HecQ{;Tf`zF0zJZAz@gDb{UjN^s}I+r4&E6MLzfzxOeB%HM-S!+H!@PZ(8tj z+w;11`fGTJ?^Jv@z=jsc`kLkJ-3>xX9%b#aQJXYB)&evgr!m3{FwS;rh0O<;Uj**LdouWJ-hAXiDfv20V62= z!cgA2dRxL51BW8PPS=@giCQygez@#K|Y0r8tl)N<(^R{ zS5dDRa)R#F*)!Egw^(ABwKOSOtpE2B9{d^>Y9pRH%K4Cn{zeOt zQ3+4<#Hz{@;+d*;>Y3Gr?zf>orL+4Pvz5W-`=N_YD|;@#7nUcR$vs&2Qu!PcdcMPs z2Afo!U1Q+7FUeC;J;Pd8|l}#NOyYAy5-AWsNxtMTQf)f zM|}!aEb4ymrY_T#i4-{sGq#mxcPJ;j8yGruW{`drUf-@FGB^5?v^zEBIs`V#(oFw% zWd07&%iA~grf3L$yn0L6CH47=cHCz;VY_wDv&Wciempa_MKHQlX1cpWcPJkk^&+-B z?&b5IJIra=)0Jf65V4RyNr37fvBf_;X1P;@Be(Nr69Wp+Mh8pD6|oF{Yr&;iteOp_ z!@!*RsgPwjOzjq9wGz98pn6>zSGv!4-VJF1(&lIAH$e;7oV7ffDSmFJ;m5&>$mI;} zjIq&IW{IVHO{=h2rlxgAngk!Ot^lleS{eK~M6HV%Q%zCy%|zhvtG)G{qyO3z!e?@ZOK1-f9!ucP3|wljQ=Ztf9Mw6 zIjSrqcEgD5$$YrMqOM@haW_wf>TYEsrHhDfO0&x|@mf!{rC%%_2A$t<`W@o0@;uk> z@(9&sLBnCscr&@%nbI_&j~D16+|LiDq%2s{ol@m*y8+B|dG%?9MF&6du&k5>@EVDl zC0m=^)HyhC+dAp^Bmr??U$7ruRBH|Rl2D$kP4K)c%tfa34{&H>-F>4gEegvQITk6r zlbj<7gT-6%Pl&kpXQ>&|vGm#ymD0j;vCT&Ga;g$}cwFOXxoK_J$rrH*z+o_KhSBG~ zQRjbkRqZMynf#b~oKME)iZp!qR0aQSWy3y)((g5Ynr~~M&oFLao?BQ@_knDb%Z$+Rbb?>i0UA)88YQ&V`S<%I02uZn_xs!#aj9FU<72!sX}-;2Yr) z9>oUKoh~zyN9R1LV`sGD|BmQ&U>jtZiRoQJ9J-9P?(9njg8;wfZ;p{WD1QCv^+g#> zZqC|O9$Q+~xx%K`Nd6yHAiAODVW%JKh{JIi5`%vZftP!pZ{AWm89{Kw|npp6*a4~9P zyitorz1IS4XV(d|i?U zaEgfYDuP{?-$9=PF}y*pHWfU2N72Pq(OQod_SIW&ci;H|OV(VU_ZW3X2(ZQ5oiVpl z>4yfWx_&dB`W)EQrlj+m49tG)_Pfus+b~%dCO64QMY|~WNSesq znu1P!ZZ256{%JhNeIbDyRpgTG9Lh?{ax&-^87|5mXZcg}J;P+h)x5UYMty2PJ1n1d z=M~8^@`^hoII5M_bRLf;+`Uk^zhvlZXhJ4FzN0AalwU7sqQhbLoSv7gM6&A;woGAP z5n!Xdt<=1Yp|jnk2vUt0(yaMbk;@ekd|xqcDj`)wF0=$Hn;I0^RyianhOejPI?Ve; z>#6)vcF4>9$@xk_NL>2|v==;Rt$^{7-@&HZ`!c<%APym|TmHv7WsX3020t^mj$UdZ z=SQTjuTO(!g^qSYoh%;-K(H;X%h?s@_<|(7UH+Z`w7GxwbC-ekPRy783GiKfUD9Qx z7ENgIdFZ*-1JDtDea1l^>g2hiX!eNQk+uDkCSSjS<-7if4vG}>q|<@g=S=9&$$hC+ ztbegsaCbLhx|<59K1X&AvkM+h$#aLQh4hw{Z8o})sMm+1zH-0wW%rLqg-8vd1H`w2Yv}rx~ASO~qtnsd>isMFsnu1wRFw_@xpRLo(tk_(W0TC0q z5wgmw$hYmmZow4Ir?XPA=OV*S>-&Svr?YGDcwa+a^4+#UufVVyBHtCj92@Jo`_PKs zF6KtCc0Ucdu!%^%O_(%rbTp>uU`tmtF2-jPn{F=u;bvTy|-D7{|?ooXlzGjW+onxHOga*&fH z=}g~@jQAdmyJ(|q#lzqPm6ZSLCja#j_ptl79Bo3})0>)df9gTnI!aHUa^eb4vVxhc zDU1mG#eeE5d@wCzrMb(i0q#->Uz9KARuo6D&@JWZ{88Gq}B@E z(m$6_e~xbo9c`VL6H0B*&HwI#6731s(2*pJm=c7FSJMg(PylN%l|HUBIrGicQEaj5 zBsQEsg?I(isKTUbk|7gQE1VQeoj^F(?Lg0p%??V6CTqzJL-noDI zqTKv@CH~B4LfX*A<(20EPDZo(5(r|iLJ3kab9j~$0AYPZBv8Wo6xK*?j&GKhr#NBT zPu?dA*9I<>yg)x62oZ_Q?r4jI{J=Lr8`!h%Z|rGwhdm3WuZHbWw-*wQ(v{fK@q`!-T){nCqL`$jO=0hG}q39BUd`(e2js+^A&t*_)lDi~j zZ7FLjPLM|_M8z2tm~f?+-%?oiAqV|t7k4uMeKPL48UAm;KM3D!0D**oKUE0xzP4>q z7;Ep$!CGb--MX`&f#%ulUA}FJAEf2KghQy=xW{+C-S|G}RX0!Jn;OPWm!uZg3FK82 zR$TKw;FgB#W_QyNg)$gmHll^%2=j<>=?{kB_BO^&IF=gduX?u7417UavXDlf#XKaE z>@i;k_l#%n{csI$jg)`ok>*MMi<{^C13RN{4-xIS*}3;0+2fFUW;mm7W;eZlGPEn9 z`6U#HbQ0|_W!RvB6-#SHoJ$)`(j-Qp_MzkUe=6|4`3jly`exor$x4m;7wVn$ytlo( z+K{UwmT@Go{>PZ6=0&#_TrvW&6_UT>J%H#lzEmRM=C}?=V8mzAFm1kB`Z6K6Y5XqL z)$oYtS1X~gRa?t0$Cl#~FyG#G9TGCJSY$k$`d)(*SihruhOc15Q>}+xF1Pdc1B+n7 z%t})K%(@|M%-5q;2P<1hTlGU-ukpgJ(-hk zf;|Y6A8bGO{Bf9V=Fpr)a7o{vtdSsL_302e>6W+MHxUcEU6NDFR0WH6Lzx^{k(wQ% zsTIyOoed8bjtR3=JriZjb7@jF7T%P;@mG5yjocn($~U)dimHIFmb6g^ONKetajYBRR|2CEe%O>L>*fXA2!n6<+ZRflL0}A_*k(TnhcY z46x{y&EZ;B2xb)QC!S$rms7$epSf-JBy3B1)$f}It6b8LVc25vlVw%V=a_MT_Yl$Z zM|AF%*c97RS{es6Fk&4Q8Q~-3*F=_sUO3EyU8Zlvg+A4suE_EN9Q&GZM&jH4FYI0iNd& z{!(TR+4niGZ7Mnok`E8DFs6Me?JcEs=T3Smu}Jw0-k^7CX1!59EWNgmoYF$`0qftI z!))s7ReP+?MuPcBDbMSxpYPUR+Dj1>XA*wePKA>uVfM2(Lih;^1u9h+J1mQ%`iVL7 zoz}Yaa0RRB> zE2<-%4ZV3~5k5FfYUSU7^8Xx4*V?pOm!fkM*IQ&V-+a$Xa49l0%gOOBhQI>nHinRGH;eLv|m`E}np5nB^`^43~JHQJR?MOy0`d17(m$ zgz=b0lGUo4^+$OeUgCGK~bH#OFWr%x(AH3=>lP-m1{4?befDaX7-W5z?SQd!! zXmxh4S)3GG|M)TtVc<1JC0O1$8do2!nF8#HSi?Jq=&X6`d?W@Sxki zIIndQh9{+FgIDP3AysRjb?QG*kTx@E{OlRF6T0rbPU&ya_ms?Q!dBY#gK0&yxF zem?3C)#C2_kx2eMaP9J}q4-ZFvy2l-F-a(pyK8moO|CTbexdNv$QZTkT5b0afK_^1 zIHKf}W4Fn{H;!IiAp6l2Sq*?xcZYIp`(7Cmr|*E9VJE7#qPfuVzC}T;KcUy zDc>{aIwvNHah%*iD8GZ|3-BvakVxREXE=}E+r3(_7&RXBS2p7I0bVj534;SvN^%;o zmNpAD0xp4^pYiKBxJAFOIjzWV(-xbcxQtpy-Cp#(B1xbi=EO_3iXI1$xBqnAl3ooq zzR;p`qAapiMtIrz$}Yoq8t4GrdBpc+A90zvg7F#?_z@yMhNr z#!oDJ@6=6)3yq!s@cUw*on*F$Z0Xx(sirWn=*u?>es{DZe(twVR(uWarD4K%J>jil93Z&Y zIYYVA^fTBB3+;0F;odM-VBH%l(T)4e9mLUd@M{vwmQG_7C!9T1Z^vM~e0U%ns*|kw zc5PYNgNbrTLi-RuEWUIhR24Z#YNI6eAUjawyGO|aw#fmV9@{j|kQth>;oYdP1$Wbm zf~>D+oq)NjbDF6{|KM^T9$#m@K;L8MU1DngcQL%hK^?lvpF1I+Y#XN@u*|sj zkJ;va;<%m&X`f`8ER;buD<+VTMKpmW;{$Kp1geNa zO+1T3d4qZ{_lIC@^p?({B4^R-ciubSx38AQG766rv*)L&e$&$bUe*~BvHXiFO(nZZ zUF+GX9_7rf9P<|Pvqr%jAi<6N$HU+%q)P&sr)r&5ChAH);c|URqI);%=Wgu-Ccl#k zsK9CIuIUV%=lR~dHyN+~*+m9^ex0`26OYfRK7{^J)i2n7D1#Gx0r=CF+DEa`8T43tHLF##9fK3Hd(upPoV7zwG!ts+lUcW_*&C^AnB3zK0DK0hV)udp~m1ofg4Q8iaZ12Z;1~>LQk> zPD>j|;oy@Su~cxzsz%c_l&#r}8*A*H7oP|tJr6V{s9{IBThN88tihXK?@>^)A8kE* z#N^gBGwKcR{6!>LHtKQObaf_KG~nS_s3kn5#Xh@yWAWkB9ja-HvP}IumUefF@JL-b zhv?6!hbbn|0{RIAchV{aR!5Xxt?9k0_-5_|2YZHiZu=}dspnwZ%M24gx7>N^A@9km z!ckP=Z3g8wi2_EB1K7y!WAKqp>2>?GHN4(huJ1K9MAokpSS_}P3Et}BG19TG2TQ*f zJ(aGPr*`UDS=aX$P=y^`*&gOzGCCXc?Ch_tXt7)VPC+X zJ}U3Nw|YrmKXef0Zl7`RyT+KWLak;`Q?k@`uqy_4YTqv;S^m@844X3nqado??YS;a z+fOoCF~Mc^#iFN^H50O^1%2gv{AQYe3Me|p?5{zp<3%M&amScGbc1K%*H-uOxKR4B zPLsP=PdBgrm=hWeh1qHc1`u;MmX9`2=ggP}Gl+i3PJ6f=IegBw+;PC%NK|%yNL`3D zI-RwDIB?AAX+;z)G~k5?a)KAiriwDrk#49hv$=ON|43DMEF$X83jVz$D;9lkhja*! zik{UZv|Ji#> zq3KC0f)rJWrllfCD?kI?;}U|_^(4oBM zq>Vyn-LDobV+ORtDjImQG=}OoHp$dY0L`TU@oIPTlJM1vAE=n+^%JhLvpJsZeF*|m zveT(q09Fc>u8gm8{fsxg1tzY1`nV>W_o7jOD4os2;fr{h?M(ze}KV)Mxi2iUPM%KX&0 zX{)oM8~{8~Z;~*+8uRW~iY!X^K7`MQv1hRnvsHV8*|rp-e!*85rLG&}ATrU;a6VTT z+2zCv6S{<&9FWA87&13u4pjazVNvY$j_8@d=JG15m_Tb#Y|L(JM{3ox}%8LNh~&4BHY?P||9;~j=d-%}>K7LUwYOYJP_pLow$YY|g{2}vDpu|#Fb zdwqEpV@&Wv=CHS2TR@E2HL|leNBjL1g4S~Tr2W_F{Wn#Tg{1wHr1u;-tu9V{{PGVv2g4!nQ8E2X4+{r!%)M% zekWyTnx>IV8_?P~?WN(G9HdSZ>$j6vb~5h+p$ZO_fPDOR>1VE%isXyP%~kqmd#Ndh zPyCueb{|RgrV?o(=xJ=@kkNZ^rmA>}ZbfBdJ+~c0<>ByRAPHB{*DS6VPnYD_h~EC; z_&OW2A29O({l&r<=r{Smf`H;g=7YN2#TW0FBJ|`T0|HL8cNc!wY=sS^D#B>U!(diw zC)MC|5xuC#k+b&~l@Nw&-zlLhkBmeT(L8^h#iMFposI&ahd+7#=YwEvSY&9c`2 z9yBNycA&&dOOaNFaO<`pk~Bb@Zzrj*_0GL1_Jlh5-KrAV++zADzAli6L^?(8nCnt# z-CH+k*Zb&u{~*iDRQjsR5Hg)RQ07oo{_yh*aiiYU6fw6Mx2fs_^(R*Xwv$Jl+WtCX z)*nZ;2oC~UICPEPWf*CA=Z?*LAjd2vV=Kml{@KjPd~m;p%Lhm!Y1tlHK}6VSj)+@8 z(DTlNhmVsca?-zQJ~$2r({#srcgr-bIPfPlmk|Nq0RTqN2>^Ff;mqB)FLD4qdMjHA z=1eBu0Js;FCEc^*2Q;mq&baua2h{U|h9FdJ!?wj&VWtpJ=5v?&;?DeAu(IbG2Yb(% zLS%$14B~6ZL+@xL*lmGo#>Trky;!5g<;_A5BqG=JlArSxV85|HeYNFbnIZ5}XW*^4 z3xBUfo)6E0UzLPK*AwpLpJdR8AtLOJUQ8z6Cu8s=C!{tRL~FKXbSNsGT5C7WH}&Ih zfy9e@gj#lIX>~?Zb=obYc6qWSw~n%JgBcHT)ESprNKaQhS$~~s{tJD#UA(z&AyD2c zb|*IpUH7v|ec65rI=^Kd%48&EMH%kg6^qCxbIDRz&$7lD>*G%9hOiWGy6z8p6N{q-pHU+ZLA*3W{+p*QG(=75wYQd?5_S;DO&ZRKX zJ>HKg2w|IkKW2!bBS*tJjcD12qpWUm(&hrRau?V(DW;|`ejC9`!SY=x&h6NuuQ9M4 z|8in5???}6Y6nQ({|)-5E7?YIy!T}vO4vrxy_UE7c8Lm!=rlbJfly;GSC{oCY9EQl zay4EgmBBk}C4X<9`u00zBTfctw&wv6N_$Km={{eg2HZxIb&DwXok$&mBeof1^>~?Dir@9{Dsn0|3TT-=N?wtJOQ1h6$b|&CnfX4n*n{qy#m!bLyM7{I4mP z__BcAQIl}$UFV^A6PZMvh(5*)kNN}wD=!oUiU}|uo1&; zSgSKxYwryzwsHJ=6l-{-)YBwrO&#NN4_f+iJX|K3%!TpJxB)vzl8qq7Q(}hoa3Gqn zHN?F_z_??EZQJSb;@n`7cC4#Cy$3vAdshAYN8Dwl?3KQ5w-i4L$I81i%+a?+) zE3n9aIvYZeKDIp^t!j@9A)w##t93wH@HF^Z(OI5f5(!p(t2ivrD8p|vu+&ESon>_? zdkaM5n>Z1(PmVnE_N&fI)b)_K6+`6_H|JwWcDz{ekgLZ~GStIwUH)7aoLY9&zDtBA z0<`Y_`S?**8-W{ay37)J={_cLdOYpv|N5@qJip=dN5w$`UBSIn#t2^&;;O>QudAb~ zFvIRj!wo^12NgwP@acz-(H zwiqf(FUS$sK%yJvYe?yk(ij&NFW^gVa6y+m`wXHU{$LaVCPt2NEPR%PjCmBLpVxAr|Bu#h~Rw^LMFoS)LOCtpyIG|pfOVHqnknZ^1@T6b*cXE zeWSa+Z*<1iX?MaSK9hG}RJM+Vbj05eV(k}qTJyD>(_icnKTGVVUz1dXi+_t~38nCu zt1)HPc+qn2wj$~C#iFIpS87j0m%bGyW_EGYkPkF#%Zol@9FN{I`TiDTe97P!tL)!3cU$1jnV*Z5#)Z)0uI`^mMzPzMB!*t&D}J%N zkq0i}|65KD9(4ci@)XW}|Kuh44Tzh{n-P;=e4}1eB;rYOQ6X@V`#l?(>`*OHYB+2r( zExLOqMq)gqOqXMi90XI>OO%vsGT0=>q%lS?^byhX&h6~V_{ez`4A7SA68z320}8n~ zwCS0km`ENQEFNtAbMaA#K8M7o^aFp2>r@qVeYwrE;x8$`wsMoU85tt|p9=3dZN~W| zOloYGXHsBuUq>R-*;V_D7zh&cu0?w%HiQ?*nFiwxzox|?|HqL)O!p1Fd;jG?|Nfm9 z_$Pg;>TG?(=i$vu+nEY?+wzllUx?>l6|j#fEJc@7$jVu5Z+d8$DeUoj%JxzN-Be=R zT>WBd72O5j9;c7SW;h_(Jm}AU&h$b%ir9lf;5>-;KRnN4C>~O84guGvCx*7M;ah%^ z2eERrsSy+@UU(PF1ILwf zxNZP*g{g>R{csIMoGtpOCA`2-^d!+F)z`wrb2UlQAde53GjsEo@DuLS< z-d_aW!!BEGl{kG3-qxh%#9;hF>s_jhvrKmO@{p@RY zJCz8Idkd1vm@Qr6*4ydk_Pg@@y?dIKcFw0v!cw}s4exm0w0P8O*Fm({rNPutMW3*A~ujxqb9H5-Ox1gi|-{;hXC=~61}GFzO5*s~QQ zS?|f5ckd9pT{ZMs{MP?-NL2oQ=rXt2DotI(96!gt$j+KSveh#~h7j4MCNWS{F zcx|ntBDI)$j(e`ODjKEd zo`x9B`(xI?G0(HGLN7DJw_c(5jL%H@8o3V*DlzMYfVqa;Y+V+KgASBv_-wUwZXa;h z_#lx^4FV)0-jt z`;r{(w@+}c{PX|V;v&?Rj=T35nGMXf-HluEfApR*AJUm$LIiEnm4)-8@AT^sp1p5c zJC#ZMN>`*Y9L0Mf+(}Zm`OG=$K{$FNMqUgvRTl#D7ALnC)mhd=A?n2V;tG7xJS8P{ zR$3F2M3>PIVw>2GfLF%!@z0L41K5WS9=&%q5G_D;Xj;8iRVGI=QO}ZpZ^eF)Hq=OX zNWJC0@31HCoj+RCDNw}dZgbZw3vPK!9gx+X`YP9U|$v(YNPsLv9?26 z&SV_^iOIk`+bF_wR19f>WRv`e%qavx&I`7RieL+@;ZrSH0bMmkC=y$Qc7Ce6O%*6$ zoh0zHLQ_{Fi3q4}sL@nPEWOD&M3$uIn?xoH>5w07Fx8dBNUMO}_#I}8YcSwMk#Nv+ zKyLz^U^G)#i$*#_jzd~6I*O@;jzWvVCXKY_uL=2z@$(#|EA;0V|Ie*J6Zq#3K&@9^ z;B_U?wn~dW4E17XFl4}-OyVvVTYXRsx5TA{i5g*yGP;}~L_mj5%^B($QJC-Y4cgqWC`2p$kNTF}fAJdP{Xf|f^mSUn44&yA`*UWaHSrE;fe;=1Ma6rZcOgPl`n-J7G*m!6z>V>e80`aE%{Q zA4sq1iVH58l6URnc#JNxicH8itVBAk)ME~^-erCX@W5nr&pyQl15uR`1D;ys!k;dm zVN{%6!Yo1w4j;RjdHIw)*E;z%Z`JpR!l@A$iYj|IF^LuEE`Mw7MVxm>Nn7Qd6}&jw zF}U{4nlrWCnjfT)Xg;iZ#F?@n%aF#Kd);nLaxnGts=;pQ7&g#7BjPF^TpGgGgGHMb9XMKs^x zdQ0X>Lv`qR3_rk|bu4wAw#hDgafXK0~ry@PV8y`dsWa|ZVM{BSSidmA3dLiBcQysJ_G0~CViCh;RteE9L%Ey>3PHKGVf65 zQL;I#8X3X5yqFbyV)w^)Y3$owbZu+cW@cxdDXWNA?o6mbn55R4SHyDBPub4ow1a?P z!t>xKg@Ly{{DTL6c^+v_JRzcRk}vHFYO;@#2FOBQSBzRtWVv{6sW<_`oKGTrD!^R@ zJcWX=lG5jqn^SoPI^cDp>s+sij$KEPFdN}O_A{4aj29xWB?GysV?nqypt{yu{_+?A zI$skAq|C`IDaDGCxa`9{X@aXB{)0y%ZP@O7QmxSqHEw&}W}M{GAvoKVES@5+WiQLYbqg@mj)juV7OU1$7OwtiiAL!j znSsaziffiMZZxs8@r78}SM>Zl|BUIg9i$J}d!-ypRy=(V;+ubDtHbaBVu{6o|`38D?fjvj-Ent z8Zrf*^KyJ}B@?jJ$lyQ7vgGfv?FFcVf&s)s|70+vXO4Jm?_e-;$6)s^8J3O`E?tr}CRb)KQA?>#(mq!=0 z#GonYWrpJMUxb^X?t}GM-5b;gT}*T#?RGMEq8rz6efO^Q$JgYKw+B6tUs3tj?#mHI zqw(C|Hsb!RqO{P;yxq$g@czIkV$WEz{&-LB2N_FtctBTPigGr)`s-ZJVL}?di|;~* znp<^wx#`(JZ5P8DjCIO!z9<80@vQFPpeJQ%NxEDfG%+hM51OIE6>Xw#X_WJULiqwj1kUo)mL2D|GeyBtrARXaA<*J1ck1&Y-UdG3-;MW^}s->Be)qNp)= zK2}w;ve|N%^_og(+Dhu*cdgvpD<)0E9mKUK5}(B1Gx!$L#(wH}aulh6Wjo)?F?a?M zQm#&(u!RU}A(cy_T*GvCCcjObuZ=l2o&~LamM1*Fyy@3zurqo@@sYKmmh3UJU?xw9 zhDNxTwyraHEx-Szpo^7nmYZCH{l3NJQKouR-;jd}-%-1zder8d@3}#BecK_ccHf&` zHl6oB9T0BkM1$v?V5Yv%Wn9Q}=kZ7%(a~M+F44}=!()+_UhC21XH1>Dn^G1_Mji2z zAI~}^_kA3>19me+b$$A6to8pILd}%jkfzs~mRuZH85GI`G|Fzk_nR@2>4~PlY_NCN-6qi1q!#%4+WV*1dOeZeR`$4G zCeOlkiwe8~O1Is^ni{BfqcQx~Nmp{~36}qP-V*jh2bTIE_f{IvUo9`H{lHuve=rMc zYdqY?p$rktTa=$u5G8iV*lVDahfAL!Xs8Op7S3VEC3_^166s#p!GHCQ{np@Tb2&cU z9(@5euN-D2<=Npl0>0{n5pld@B>^4{ZGKSPVjJZ~FL{E;n{WmZzUp`QJ>o2a876m4 zsi1!{_8gaemn0R>#)R!xdy(cWh(V#7oMx)yzj#{rxblo zk3DmxFFbo)rta^S3)C9A4l1bOcWisWdL0*XHUs+pZ`1buLHO6tW=3x9kBHzmHcE#@ zSzLcR>mYIgQm*4JO8SVuqbX|yH@Klt93yMl;FCdAqU)#hsy4`2OgCdG02e9Ye;+tp zUnrDIY^{Po0|sqr4q!$F5a**r$ddhBZKhY(49|x!N{j$H3E~a5drIMMD<=Zhi1#)p zm(a!2gl0g8g1a1>H2d|6!ub4h?NfNr039Zl10BztWtQ zYAbC$t-BOJ3&#GE&K(RH?fR|`UV9WFIS&N4_9i-(+bttz@^9wc%6dfn9+IWu!;HuL z!RsHbXIQV-Mi|Lhs2Fo3?APCXqyKis$feO?;f8|Nfz^m~_n(m)a0~QN}rw5oCW<7hgki7Z^%u>IGdZJCPH; zQdiFYkvr2*-o%-%Y7XkXiiVF2`9wvne|0aq=Y8S^E6wb?tTT6^(e3`jL~+nflJnAf zO>1~DxL??%tt+pKC5X)_D>#m>;ktJv>GIGHTVoy>a4|r#H#&q$GFub ze-kPL9QV9wouc>B6lozhZ}F>KFo)Kdm#t*ug%iz6e)dx5ji+P!qU9thpgs0tg1;}- zB4Uy2l3jvTF=)r*={dFMcwJ#cZ+SDBD}OKR@veS0%iqe_KaXNV%bONI%5=|UXO^+# zphVA&*ipyyLGHrTOw^w3d-@bq3Xj?lnkM80VBqxoE2eY>CG?Ppo2P{_gkh?Bcg_T> zhPt~mcGGkoKIEWzK$}D^pyE|+P?jvmGKyxFP|lW_doQ_{NZw<-whY!-;r8}Wj*fSy z8^`Mq(l!rM32wyfozm+pSV6r>cIpW0^rbxPjTaQ%hYz(D;0c(QYs(fk>hoPsLnCVy zMZjA2>8FDrR(Ye$cR8o$no*Rl{Vy>87iC3>5tX`$0ZEkU#JCNJEFczn)cXmbMPyRfFti~a>p^3j z)AC|M*e{_&#Qf3r@cH9O#u=|c#P2W#Nk?ja3^CI*FVU7oACx-5{Ff|6aE<21n7Pl9 zX$)46L;~4Qqg`+S@NCQyHHB%%2mX%qd=(Xu2sd9hN;9Q8p~adJ4-J}!@#{BW=lQJa z-mdg#1BZpYiC?8?HGF`}6!_aZh>|vbu+p;>fwIGW2U#xd*uR|$|AZ#FxN*u#N^6Qi z#qL7%X~1V63#5W|g9+&zk~4y!A8aR~x+t{7*;+@qa?VvV^LE;Bt2cEITK!zg>pFP4 zJ;M@1h91~C-&!NT+SD0L^B9u1DhTo|tG2`aOfHao@{>)HSz%+BP=ztRbVF7ESA&qB zb&W_~lDh-qly(q&;uIA!oE*2UQFWb**}N+xSpSL5@Lj>g6}@*!BG-Fm)-$&;bU(^p zzsO74t@B-u5O-TK*)pG$NQ_6%2T4EsArc~EE&Cr*O@;Ze+D9Z4wap$FTI*-K$4d#B z=Wp-Q2uk|4{|c7GXuZS?k?V0Si2zsx)ib3;&%R+@;XfAcb~8puO6KIY8Qdcz)B2b+ zIoWVuqrOvpp&?t;ay1<+MyDcgWd1rB!%x~2(Z*jxcJvI^(``ZLNlr6z6|xP{H?ESJ zCj+eh>#+UjvSLr*mJC^XpnT;zwfTum!u_`D1a^eBL@@c|@k zOz||2%GF|h^qBBeeRj{2XKBqOo9>&xiY28TtGfVW9a^Cq;uas`I#aJtAVL#*_wdQM zF3MfbkEt!3(|tJ}Z*x8&tqGEHx!SmN$7Lrlcl&$s zGflQ9V~1bL1$DWu#-CH26FxaHFFceyuDN(|eLR)>*6V)P9b7PM;7E}mQo`Nh6c4v@ zn`l=Qj(hTdg&hChz5KPHSVO~GgSAhkMdA}l5BkV)lzv1_eu185z|UHjbqw2Hm1bBk zYzyzduBMBF7hub15O5}@yIhId1;c*);Li2wH#MsQ<6s^Wy9Qs^Fh@1y)N$he zVr#ZSFU?AE@Mk)?sPxQ#*8l}KTgX?>U2xNQa+d?pfuEDwu*~0|K%gQwtdya8f53>a z%m_oz~cQ&ZSFn+_+Tq#$kXd@|Zk5eZIRT~AN0jxu+OHVmOFhRV=n2bK2VJPCV z-LA>&k`$f*eSI&2-^@kd?YB*i{<%6en-);a`@DASxXX92+x1g9LU>PhrP5m#o+Wzt zO`soDR6#pFNuIm&**KrD>(jjU>f3DRMx!D?UWR?(o^$&yh{`Cii)2 z?MH*jBfvd1`X->BQ4>k_DRi7uTK&s_lLre#el)R&FK5#e&1Nai2R&{>4$fV721Ly} zBoFd5&0Qs!W~_Oo6~)7NsZ`ER(%O{Z_eZ%!Vd=d;wmIb7Ykms<=aYUC^(5Xa$QmBZ zOdkK>HJyLyg1@?Sz|Uv*9tC9+br6Da0qm@m#4hsl2`AB#Lyj8DfEP`N zJtGxK%c8mM%uIp1tLqc}$p8QN^69XFxMkL4o9krspRdr| z2ow`9eymhgJF(Sv6rXj@DQ}glS&Ts1geK)se9p{Xfem#AR63G`IDY=2}5h^<*3& zg$Mni?9Xom&i`@0lKG2U zSd^NbnVclkm-v`p?=R(RE;bKGe0}8F9gCxrDK&*UM};&B;u#pb_E?QfKWVO--~@h9 z$=E<^aeNqTs9{LJH2d|RC*Jw`kO9-Jfv3EUugPfY+7Y@Vhq)0UG$g7Z1=|%4bexfy zbGjI2yAY)Etkd#$A2)AHW>@9oUY1RhAZ~4Qehn>;4W-AjrQ~Ci(Ce}7R2z`pdSMKx z@%$v{sepLUArH8NV(iAEN|r~D9t&=sKNbK1c^;1AupG%>HfaOtApS*NpDs@jaB^vYydG(3!!EAdUvriE()JOqhZA9!~^nzrrpc#cZ10b)tGF z9^ZO^Yw56X#HIi2Sj2#eF^ihBNrn)DRPCQjLV5g^lxoz1CUm|}d8Wa;G)3wtdV2)qGf zs(akoSK&+De%KAx53i6g;%H=*9!qsR49xFZSDED_%JumparRJykDS9BxlfM151R~i z7bsbO6Lt~5eA617Rn}Xo5T>5|5Yiiv{PWf=XY4QC!cA*lYxZz&z3RC`vM^}vvp?pg z{n&)WYXA24`aUd7>Z;k(AqMj;`t?{P`Rujo*U!Sh@hx4!KRX_8mutEOj{$A^x)C1S zifdkUkh8cYA!!u0eL4w-u~*MEmDcVG&O6(c+hu~?kCQz*rLk$g=g@-v% zAxF*^N_A99r2LZDgL!3Ck;R~ABkZ_RH2X+YM;cdgB<8`%gr?T$p4<_#83YFUXRzCj zirq2SlI4vJAAw&@G#ocQz$Whb;ZwcC$}}cgi!d{{0VHMV-dJ&hZ0fa4U$#7v zk>>{&mWPNWy2(*9o;AXbAUPpno_Q@%!-{P<(?hAeji#%0B-NMz61FPI z)~|)aaoGUR?Pd6U^N(!Oacy6H!x;Cxfz5r7w!n_y4GD^|>7xDIMG5|Dq&(Ex6u337 zP5^Tn>P!u2bEPeBS6qOq?N3EA419#`9u0{VxxIlmt0TsG{-xgjTZsrGyE)6oIa5(E zew>T9Tcx-RrSci7ky(uQ-M_Y|ta-{nR+4%jI`$Vonc_;A%$de2xyG5Bf*8za9GJp|v`gh84vWi z>!ufmRHo)SBVy}E%EiT6K%_`Wr%3nwKJy0mnU76h$hkh)vQG=O#AIZX^2YC?d)$fP zevIMdV{#5~UV0bYGE-nLMQ#_x7?cZB-Fi48QN5fB+9qwCu<<$G$0w!9YSZ7J)fWfT z6+n;)&)@mzdoOHTQk_GGY*S$U(-Luicgg>AC{@C7XLxaTxL|s@f}OD5-hV({fq0dJnX6BA2ogOnu>6a-6i@olN3ZT7VGPO0G(fcB`6Mr;0<6LME?qEu)ICEl$& zCF?Nsl(au-Tcjv>H4en}L3p2W-IxC&QQo0qBH zhxL8o(Xz)=$-w7G9jxmNSFV?=Hv5Y+%}aY_=XcqBji$E?lpZ zou~80vaxqfU13}d1Q;s3my1buiX#_JY6OQiOO=o6xDJ*lE0nkEJ}rfqAWIn}!Pv&2 z&f}tvO&ORwqt#CT>v;;ifb&VADFNxNn1=CMmhvIrPslxkTf9Nb!T7%~nMBn`5NT?l z*#%IpM8~5O2;VLzh3`yCwE*2>Ddu!+tT!%s^65s6d&WF9uxrl2oqX42DE@7s$U+l3 za?MSRqtKQ$tSQOFFBRA>CrC8z-8Wi6^~#Iv^UbJCC+Tyds@r6uvtP=q(W81ITq9#e zKEaV7v^^Rt|Djd> zH?;5F1N`?2!A3dU*#1}a$u}gCE2S54FNv{A;853;Lp`z8r2C+D2AtQbp|0HC+z71! zJadeG40wHE^&;d0G$|RLCbvGMNEb3wky|2mg0?F_IVSpmp~OQfX0X!+l5=QsmYm-@e3?3xUL z$CwXMfmcCfREaK+bX#U5@8pK9P)?0m9u7le zsUiDQHj$*vY1+SJ0hxxkBluRLeivi!`mOT-l~|XCMQi*`uKI6F?uZ3xh9cB#iT!Pu zN)}vDpi77?c4O21$Yqk&FQego8d5XP)jnP4qKF>RE2?_uf!i#~%w4*7D4?IZSH_-N zBu$;;1sI!lnb4=ZJY9{5=O-1%Qz@Ic4BBT_lV2=l<$c{OM^PW9-M(j7Ml-g@^z`b(XrLsv^RLgwCyGW#zzV(OXB(q+g6+BPc! z@*1|hbdLZuG_7(^ej5fgIr2_wHg+fgwpHx^FfJgd{`djdBj+!>AJaa88a)zaArr0% zGMR9KZcDLTIJ!f%i&4dQ5GYmCqnT3 zC5$asF;k3Pv7}Ej$%$Bv3Q^T;@8G&v1r`Q-JE~VR$gf4P=?)O_+DcKGn79xzTMF*0 z=7|)oY+fob{Qn(?C7c#jsy|Gyq|0lP+kj;>0+Y?|IX1?oF4xG~AkM%d<|8*$3+DMj z?8rN$pj{kA?(^gM6uhoL-TmN^BXI`v^K_@WGGlBy3LDJ*`bNHnWMdn`L~l#k4iIW; zLSgE`1Pa5tf{5rE+BK9YacR`=Ah~jsLI>+Fl!Y+7);6MIGL9O*MC&!#-HXA!a&>P# z-hIe`ZeA#Gmg!)OGfaHyc>-&t1+*R|2~AD(`ImjG8;C`xuFge<5Q6*m|`H8 zxTv`c$dB~waT=?I6cyc|uWoJRa0lWuSbOtX0Wi-oY0}V!wL3wv&}Jvj1G`4)c#^7q z-+1!xlMR^2HR2JCGt^=@EZ5zPSz$-Rox1Y)DayCGcdmyGl6f_6naAOmqA7XEDqN*# z%+zQ_)$yCJd>d1`1bq#@i=hRWPP`u)$zB?4{$EeIF3xx|*f-Kgdq?F;Ab4MWYlLPr z`VI4PnihGqD-*_S^pjb%O|;|JXU0_@iv$-M^VGg?#+|}ST+Q%Qq4s5BSONT&8H!Xu zrGbN?064;FbdH_P%u+;3vm=(2H8d`&?@K7S4|lCdxsx)CLPE^#)7B-}QOfUoa)>pY zB%WfOl87e4i8e94*JNKD>%kUGW?HF$eQ310YqZf~?8_6mI&#iGwZODxd@f_M_oKzl zCw2ZQ4=4@faRnN`Y+~D)l_0tk$j)={_^4Qb>soh_(86GKn5~kb^r1NKC$;YCLu?<`$1F_6j7lPOYcy|Zr!OBF!1Ek0hTXPLOlsD}YOglY z{Q`ppc{SteweuMWezS{tdUCS+wx)I;V;ZGIRe#!CaghwTj7HcsfsfH1u!xM(SW8mL zw1Z!Sn-=Zy4y6EuK~Q3OZ@}TmvFH2Bs%-5C4$`@Dr;8Yp3#A$fszg z4PK$f0M0dFLa$O+06i+cm2lt|icGtFDyG8Bd1M7Xhz?E8Aw*pg*9(0kPPJtY@LrPq z5)p{iFFosI=5@|xEe9~Mb7FH24z%|7+9IDp3(hY7q^Q49yV`zJ|4^Eg#+7c<08>6i z>+x16>8&1Pqew8I;cKurPX2xhPru^5KtO?C@td;irm-8vv&;LyEv4~-$t=tB#jbv{ zbOk&gFrv}#u!Wm&TXQgyflM1AymfR;8Mh`$lK_E5rNvn8XS2pX8|=QxzUKKbG9BJOqZW3AFul6CFtYnM?sNPjcW70n;BlgeI$ z1CA|i5%bkB&{s6l+~@sHnQf|*I4bQuU&*5Y8HEaYZXi-(T+_Etgv9Sdq3(YJ@knn5 zpW#QTy)ZD&Ro8V*4qkqML+k_Z&{k<1HezE(604(q9_H;tC$C-5u1bmW{KU5ck0lfY z>t-IOMHoMlU{~`GSn)jXwE@8x{APIzk_Fo)guOZf;L4%5I$#YTiF_5C#liQa>e~ zWzy_P=_1U}=xnAHInx+ol{`RhOHaNDK$u`@nBobxCl)NaUq!Z;2Eib-^?0>BS%)q$ zFk&gl!_>OiAEV=NDpP+^zw?9)?x7ds^ELY63uN>1g28~38mW4%& z^8{-}Ff{7yivyY5X8f%kNU~0Xk;QeAiYt8!U|ZO!bn<`x0_5Hf-Q;q}`#oa5RsOYQ zyvR67vmZXGcyC+DywZ`mp7~SL4m2h@KSoJbL&mwr~WxaY8oV51ZQAj-St{> zB$#{2^O-)0eGGnFIr9qMG=%sbk3$pt_;|lGLRrT=G(R?!xSMg#bFx{tm)2KdS&`c9 z+Zfhx)q=1J6>_w=n(UHv){5x3J?P~yg6*R=HYpCh2Cmnl8*UkmXxqKht#3rKs^I$#X4*J&c=ZK6Fs?-}p@g9EYj3E}|f? zx-8M%?unTEm|oe2-%E*6ze2ZjEAQnRG*`Gwy)=P4dL7@! ztw&+CaCJqk0mUK2n;Hvx%kj?kWG@N*mWLu16q{U)bj1IdkdaxrgR}zfy|n%`iu_o3 zy<*LoLYL{5pI75_J}!3u;oB_KE3TYLCvYuYdfBS)z>ET0J@z}hH<&hTSz4|GADo{t<3 zOYt3=`%7u0Ko&iM6sY19QxTE_3r}3)r1r%uvKaqE9mf`T!=DdUA|vFz7G0*wAuY$j z)q){|Apsa5>g5Y!<>$HhDqrzIF-3r1;=HW<8op5;vI+}rm8D$oC+xCL$0{$9R#r*C zQEP>nD|yg$<0=V#iEU4*5thT)3tgGX=vLF{mT~qfm3-~^S1h4@c`J@|ZYo}OFfX#0 zW=U1t9=PP9)fn$NZPsJ38gB!y;`qJovM32P7Ym`UpTzcm#$_Z5Y{JurIWv6g^5+2u zAgN?$A8gd>Vr;Pfjj(GI+U%uK&L1pS8;XZ)Tvh9zBG(}l4AYt1fQo$e7F zGV9?1HwHyzeHT9;coN?qgkP!PD$-Kf70(>~}-Z|KjX)P%g|3wx?wMHIo!Q7O# zzOhVs9?@{}XmRzN&hV_3^7NImf=tu^*%*8&HqBrJYbQ+GjHZ7orOq@(?GU1@EpTkA z{zR77GI(d;`n-#kq|VJ;NYI@@skja1w>Md}NkK9Y`d$raw`p4%&tO~~cZJ2Q93OFF z1g`Cy6P3isKZw3GdEONIJ9>)4IVKUIkd~V+}Iy;VM4&_r9zW`&cjz zY-}1v^GI+qXFgslZIAo(O>lG9$Hy2w8ZEVBVB{n$iCj8-eEFi*{wJi0a&&dQ{=+r1 zn3v#5b}mg{y!B)2zb6U&vm-P-y3w)>E!@Ftv1dpNG@cPR8hdEh8AiUB0icy~JrZNX zdjYkdj|=xr^_CdO**@&Upp}i2R)j^}QwLco*eTs6`&h;Zi4%$cghRMkPNG0V+S&#cPUTynd*Dp$a(lFlA*q5*Kv5n-LP=5hYuPq%Nrt(XlwUkow?mTT(Bl zybo&Hg;r@kUhWHSdWd%;@!Zyx#O(JL+(_vqE>EomPOKUt>u5_E!X^fGSnsK4*xs>!=B#schjn=k5V~t z5`Q)TrbWBbPZ=nsQq(UWLd{f)MR+(dOUg|lJe4UBsi6kj2Xnn~TV7)k*9UJJP?p#2 z$BIr#0{P})ge}=%3#7ti5TWYT3B|D}^N&n!7PTzJr_qRY=H{hN&cq2eNl=InOF*ozX|YV;oHM7>(xcums(u1Rpa>I{n@+JlU2=KtdEQmC8| zq(Ua#_!r)+G~g}a`XH?LiEcl6wH7&`2n*{@3&rKh4=OtB&Q=M@Gen$h53?0^Ik@rc zfpwGrp`!dBz+sE|O_E61*(P!tBz1?BU)=v59ea6Ou&+NykHVck&$y^>D3{%cJac@w zul7MQJbGt=>Qta{Jk0=I;vySAck<^l){JMR6wJ-s46ulh1lbSe?aHTO2YoV@av8mf zX>3B88W*5I&wdzH@lrDWlSa&a-JxY5goBxUD)1c%ZI?^Zxd2z~?i0Ctm6v&fM_!5pq54-g6uog@s(!N%7nFiDDmB71ej5 z0K>G{fSBXBqoSs+@1NX6m zOF`bJ18B7Sc7;tK|3zj-Y^Xuq{ZOeb>L0_JZ!!_dXS!fb;pPg1bjA4oV+3^gw48lJ zVEi`HwpAuL)tl)F(dwJnhm;4{NmFGWMcaIw%~LH;usy1IdmT%322V9)PwQpyn*~A= zcc@Z$GM5y%)RlG@Y_6}A$(!l0a==Tjg&!B-Uc{gv#Tpa%D;S(7Gnu1 zFk^W4YJoDci!HrVk#US|@nhJ|>_x8E+o*?QA z@N_GZceeiqNFc{2l=L_z`4b5i7i-&nw8pGL?A^1OT5y9gE!ZJ+sh@pK=t|VMc!#Bk z!*p9OjjQdqR9jr=&XVhkb69u2X1cdxMaXmXb=A7qn+f`#zPbHvLc6FWg^I)RL&Pk3 zE9>zuF5eSoP~qr;zQw|r$C~m0|3E5aJ?dS+?6Nsi!qKET33y$R@^WQ?^^g(w*MC3q zHL;*6FDVQ=K`%3;0joF{ivnVC->};NDC7x6G*4Tm+`4TydrGtq@G0CizrM0wOr&8n z2JL*1yZBwF0R)Ltgs9)6ezRcr?lFScw9@wAmLnhv9SYMPjt=xQxMQT_lydkwdg=Zp z@#PI1Fi`g0%=%$?Qkp?o9Am_%rtRa1F@&F2;m2ods~wLlGoT}JnV4y5nRF{O9uI0( zWLRjBRCM98>w4;qT^s@m6i(ZQm|GTjF9-3M&BWWnyza%880MJ;? zWxjy}#irgWe(_soqDq=0sFMmDk@2|Hop2*nPdzQr(7)-VEEo%2-#@U6eIaSUW){;F z_EwJ?e&ka`;CZ}1iwzVu5%)4z6cN&?u_`mMe5%=Q$6g* z&GOgB4L$ELKzp?Qj{X$Yr9SG`corpxQi1j0)AYQ^U0GM@9YcNbXw)6`=HuI(eExW~ zd`#*DU2kTW8PB`1A%9Eb!kbtG(E_>;Y7Y&~<1GPxkV{m^?Jq@1;~tvh{>+;q~s zP!8^!vg`8hN)j~DRcZ;^UHd3x-fy$2RglpWj`3=o?lg9E00n;X4elg+59{M0I2!R1 z#je&TyHH9usIi#IQ?HvDqDpmdjw>>FZ~y#ZF!Z(PSuxfj7eE5vOzfS|nDaU$AWPky zEiGL-?7oZ+9^_w0(Ci1ET!hXe2)5<+mx9J;zZzY@>QmN6L7xQ&`d=7HoF6ULc9lQo zs6{zJobA&lJ*j)v#USA#uR?}~BdvW4H2#b5R|)6-<6J*M*bN2yKJ*q`Awf8I@5&{V zlo`I>B^@Q3Igf!^20(PzU`k9q@85;m=e0Z`3F}B<@A$w^av;h9=!$KZ@||)5-;TA+ zq5mU)3%UA7&`kJyBr}ID-$$t56>OlA@iOr$W<=fLe3_3UFjqJYrz#QADU6j%6^R{& zx^&%=xXhl^-o4Nq5iow^_rBbQoEQmW?(ccX6eCK|%C2nt23 zI78~&144-F-ZOK`uRO4Y6g}CO(i$@xcv}uvVJoO=gx|{8K{j*pxW9_P!_K?TxFsloJBfpe%)Zp} zO)b7N{5AtgvG(U&203$Ca(^7gI0c1svF1z3>%(GeiF5IZL*|bM#ir=@+r86vyO&bP zsU^RZMsn?TenOlFUc~K7ADb=C2AzoL!@p86^Gp!gNJ7IiJyoX#r}ctNSf!N)l2VD@ z!bpQogD0PTUkJawSPYWRcD8zvBH<^BDM=*Lbxv6|qJsgnTd#GaxX0zvY|f-b|bgU`2BtcT|a}u=6R+!TghUNp1Sa4{+}IzxrQ4Vy=PWuWtUu zOaE4xV-;{tjUcw%Wc>1)nF`G~!JHQji>;!eQT^FJ?a;+RUvnowmM!!%X>B|v_Ikbj z{?AHIStdF9)DN-ZA4EKmCKFCH@e~0KKE;mL472Ani6sQtUk#B+DenX2Mv*0@hiRsUPfSu! zbsp8^G3wuy@~EXJk)!u} z%&q)_ot^iZ{5k!mUDjE`cl?XFe|nd)r$^?gy1ZzkK*8WxjJ z@KUcbag(PA_$mJDmOc^&npfKW(YXN#$q8`Tt{oS6@73AoPr}4r0V$|u2Q3@;QzS`oXZ@AWE&C$k1q3d}k5^r_0p%zLG3a>J?_xVQT&O`r0s+l4ck;ruG*sa^Rv zT&etcH~B@0UovyX)lwMu>m0=z{k)!*$wGr1!EXLz3%K_edzJb0bg#?EmWMgv#i%#F zod;hgX_nRhblOmg@T`pfp-A<)P-Z{A=khBgCy-E>ILRU=CRzG<{hzNRnutes25w#h zQLX)(rPfv_RoWq5m)MZ5Ow5enm}f}jF4Bz+>AJ28jfu3h9hH)}sy3gSb{qS+zpdCL z+bDDYKh+bQJN&f%pX~ci4d`z@-PD&#?a=`O_>*|w#ZH9zY9qDtXcn?kDgJ_ zDhmA=97;+LfZ9?nfiWq3WkK2gqci*IeGJ@*FhN-33+ z#}iF_yquA~F7ChG=FN~i_)fjhUx&Fh+_Ukd?__ZHL+gg~204$)N&~)ZA4!+L)B$tU zv9K_ykh!k2*)oHZ+^1IQ9y4-g#(C9^`TE5xj&I@wj&p)w+({$p+W%wvfeVd>1kyRQ+C#*Fe7 zvR+g;G@SEX`0ybh5)Rqo-f73un96PNbJ?mnRHjS{hMi}MFDlU0p2pKP_9s&wRy?bo zG*~rvEXGVm?I!+6olgGYe=O_RKPuz2mOl9?L;r#hhs#KQ{)h2$2y?(zncvGW(&)%d zx$wNXAF=T0&FG*B9~E3&bUAXzBqdZcoZyI_Ox`@lx5zJ7?9<}y*z(0DG5x8v&O^cV z5s^|(RFy2g$b1Wr*j?TetvTW!DMBGPi=dnTicq8x|LBxlo6W#oFcoSn@9Pm``jIJlO2NQfHx&=opi~Hmc+gQ<@AsQ!gWbjq zQO_3gZ8hS7$4kd56zUC=ZZC)c)b|CAB%(0mKgMVTKf=>ngCZQ>Iy~fjcM7^b?~Uch z8TPpbYzNkEi@m0GzJegmKCF(m1U>MgHkGQi)!Q$pn#ktNsmcDv*?e^j;!)2L9waj} z@Leq+rBbf{k)!Pjph7(LrqP?bC5qQR>*wNmD7@OaI?bK(^U3?yROZ;MKaa1wg&sxpP{?|TU~j0Q&)1kXu@d7?~ss?q-56%3(?n| zl6Yn#MDFxKjcpB5czOwkXY^BlGJPqOf8ZP&)AVJ6OmY0_88u$rhat(>@^>*jwU>sq z2N?m!1^FTj=E@oZhRC4)k)0HrQ6okFanPYoHCgqn4^zL5!{Ze-);k%T`)CnhF>)== zrE^dtlKH_>Haw^H^2f}u&0~An>E)Ju)$fQt@39db>2W9bh~a zJ*9H==1Y0DIQqczO4zD(79oNp8t%C}E-PjK(#=+OBDALprb=Trin3I!`?7huT$d*} z-1%nv9RGb|GNt>U1v6*;)o-_?)RV#wjHQlpvm6lgmpd=BFV)_#;%@&jNvg=9xVH__ zW&e00-K>~c%x;`hfN_NG`_!+|Z*-yb%&K=b%s7T<|Ko0b(Dw{mAb2fk-MC!K88r{@ zl>#d08+D)Fevec#E~cef(6E}`#0>t>R=$;8KVvLMk7;fIaeNk#tM66-$3jL^`{>Uy zs1B%F53%={m8wM`SH;b_inI2A=G?D9e6AC(`|&EP4`Xte#w1*8XQtvVq?Cd!T4(?5{IeC>lFlD7ZRUgM0AB{?@vpcA% zMxCoRB5FH^<~gII=ZyO0zTf5q`rq1*Quny9MMj3d zN4%^KaNcNDh+PsLmv9n#LI@|Eia1~nPF(44>055y|AKrDa6j|MEWv)i_cNbx!Sfc?pThJSFkUr2#j;}K# zQu5n$+TpBfw}umLI!f;vI$E!a^!^Zb=oz^X?%OM?hvdS^M~t9t%huF-Jd&>9WR}Ol zzo4eOy-G2@chG$m^<$eB#_oftV~bkYl=!h$f*p1g7fI+IDJ^FXtJqH*zT%DlNcwNg z@PQR)e&R=Tq{NdMK^*2u;RF*~U2y*w9r=i*U*Myd^&(Wpx*bEb`B1c0{b<4Y#sf_5 zujjs7(L zW(QRuLvp+MTU-{+9}LhUbz%W_o1#n0WXx)>iP27ujB7q>UwLkp4qf^0`l=rhjxtssV5Z6VYy-!wMA2&`$Lr)=M@l-qoTs0 zTuzX{IbwsT1`?i4_#X#Le|xYV1L8V$K=PM?$x1xLyq{H$V#u2>ea%m+-@b3P{*JmK-sac_|?Zxtb-&$W{`->CiG^`fsr&dJ?D zlC+cS$}Z~XP~wuIh5f4#>HA4iS5W?U$Mi>lz)jJXrI5R6d`t=4)%nBJ%o`=Mhoj0S zwchJ;cg7i=jz*pn0(v(r8=1(jCgy$GqKD<)e%jS~c}jcMyQ9GO>eI@ictO*VCfu26 zQhL6Z>ExoXz{E3VXddyqOKt&Fr0%<8IM3EWKk)fPWrybY2t9og;Yoq)`Ot@MaArST zr2VludClu(GVU{!Z8IRG&9Sk;VWvsJRy6$K%T4&p8?irQW1PEU`0g(mmWhhtTiFl( zeSQ@>*iltdE?NEKq)h&u=@?J!xOnxm(9K^{D~Pw8p#*s>Gg>=Go|CHW%Of9&zlVpU zpV%fV%!GssXX*s-t};!X(OANX8DPKcBglS{WdN-(yv=b%XN~H{)AyW|<~G>X=qC1@ zJxqz8uPFn%6Xvvy<%$jychDB!!`X+|6@9gAAgq-uUw*ATl$l}G_dDSh$*^hqgwz9! zGlnO9LK}ji6Rk1kl+*d{6PoyLk~G3UV&7Jz#ar68G3mPw`kILqIPINrg*IO8x2;un z5>gdX411*{>I`tsQek2sc7q;qvtmf$rHMuT2}-@BA3o#Ri$+SQx@-H|E%zT&mR_QG z8c6b+KPfhS6QE=D`1tW_+Y8sF$;et(+jVymh)wFH6V=wo|6l?iNN$S{H~`WCDd4(t z6UohTO>YfCYRcQoSz&z_Rw1+-I=l<7K`4N}CCl1)lz%9te+1-xX9FziFLRC6Fl_u5 z&V90K88)sj;nzKtwrAI!BnwnjoK* z-FqSEaFq5UhUz=G_1O;*2lt%sFV3*K&)45izB83P)16SZw(r&E14DqKgz`l`s(s6NtVQPCg-vQ1bY|aI zN?YH}*f8D&sJ1-W)y@1w}DFdG4$%;Iy8LImmb=K z@7ufkWNM%qK2f20O{JPIcWQhWvr{G9F{bY~M()d%6sF@iMAs zs5Ich?BIlA1Bi!2ye&~vtbNPfiVg8_Qqd0)K&wN_$JF@vVV`Xe3^%Qa$+uS5ft(K0 z<~=G$e{$}PiCM#mA@rwJ49&_enzR(%l$3oY4DCmn<1>P5;`1J4VRB%X=nUh5!Ih)_ zN#RK{dnJZq-#GWEVJ>B833vpp`4*r^y4-Nw$s=5LqWl$Q%RIV$u&Scw<7FiKb+Io+ zr*@-%N7smj^50Xs*ZdY{#-{q_*Yn}JC5eHnFx%tfjLfyq!~SX@U{{B0AMSafI1E~p zq7ey(Fgg`h7mP$m?fx`Qwn{Zq^>FKUJd1xxRf9rc0h`IivxtV)QAU|1hr%jqH~Xjs z2dRC!QP?FYd>%o~xp?~f?kkFwG4yi}L`;-G0N+=Rr(BUOJt<>zASPNt)yxY9Lw%#^ zzBAtk`v-0rt-Ct$7Ci`SDJIC<+`^J=&oPxvtqgm)U%*Zc9LdVUWMignYpim zCG={9O*lAOs*Gp_#IDyz%hY~G#J*UtC8&z}hY*VuPM+NooFycKjl-k64Rx4DGK&1> ziE!c==K8wUpmpClSNC! z8$V9C7Khs(sPB+y0ObDxYYRs~Y@&i!+hvBeP~#wOvCFN;Prgi?931(`e?K4*@+ptB zwRuhZk$K5UL5Qwp`D?0_!Q^@`!eY-AIn)nw24u@GL*-{qTb} zu~`o-&Ux0BGb)aM-_9Rvw@5In@ovd=I~iHpB>DFVGHvu4qjQf6duC0IWG*Zv-a5~S zwiU6Wy+ZgCp~4J|CPM&GvA*~`;*3zLfaKCqt(lm%o*0%pF|ivqFG5t%3C}cJvss}c zQcwfv+eHzy`-eqy0kgwof*QM`bd*foSE&k7HksE16gCb+X}g26ky=Pr#ymn4LPgw< zmKVz*&8%0Z(q$vxCTY^;M$AUgLMGTx%iE+Cj_AkgV?D=W)`OR>?ubP%jYXRt;dM3I zL+dM`3d@}r=P6g^-aED9+M$;uTNkMYjd2o%Pc&y07;L*Lien4jFLzFO;RhZI3NUSj z<#cbT44fQTti@}1aZyY+e9xVVQ?#a!SywcO7c4Z-dyk!!T>-3r726A_U-JL6>H>a` zg-MGFSD-Da1X8mI#2c^MHmNofHuskjlz7101qP|UcAYxGw$a|xc8#)4+92m%JqZ;z z4bu4>P+o`bU*;J`XEC^#jz_CF^3mzO5#*5?I@DiV!aV;vdl3Y?(BS1N&}_!s7}ZMZLEj z28BDtP}TS8KI#X>ULTixGyi~qaWE|mwbhALcyQT~Yq{C9aPrPmW&wPNZIozqOM~JI zBurR*=8q8PzctN(#6avBeHa>!D35r2m*72xZp#Q8`P-O;N9mE>>kd5)k-RFp8p2bo z8PELAnMGxP>HCm(#4w9z-t*vW)*R<>%Dsc>uc8>IcakR$xmbBN%if2dBfgciaVwtZ z$o7gr5tdsBk_oG8UEgjejb zN|gFe4|9{&PERf@&TcIe+uJ&S>(F1Bpf6A(TvkOa6y!u}Io_EQ-K(HXTR3@hhD@KmXJdVyNG|s_psRr88z%E) zwjX>7&5MQ1IQVGQZBBstehsrj2O?(gl2mS9aNzrA&@sYbF0U?rj#_PnO3?^_bwCw|NoZ%4u3{^rIGY1i6jZ)P5r4w1VhNW&zXa>2|r8{hhA z1E#h{LN_CsotQb!_Vgb>-^NaH9ApX*G9Udt=(mCY7>DCUi|RzcM|}(8R(QnX9(#QT zDQ)W4Ze_1Tv$ocCIsuW+cpeOn;;S}3pQ}U?tKKRO;Nv8pQY#SMYLUI1qeuw;GHJrD3ra6mSKF>hm*X(}*%G_S|&VWuU5JeNj? zh-;&`v(Mo8C?yvjJB9CJmlIL1#sTXHV8Y;gPH|=Cp=?K#`eZKzt#f0wbo0_{ScN|1 z?eC3Uw+UdDM!uZP%x2Ml{SQrrorx?WJn^v1tiVj(U+*57E72y=ygpFmtz06(3vvU_ z6Rs_sbz42eR2^VjS)M$hB9bkn3-e8#Jh}!#xUY^2FCR5GekzdAUU{5DnOJa%NY>Ft z3Na>9G1RoWP5wH=jz6Lg+|G^DfsBhsm$hq0!^guyHe8lpQ_{8ow03lIHMAZTzHygZ zm49_47-(M{`%rfABzlnwxfODsL?|^{<=mO~eZ5{!X+BbNB=&B$WKXErCN z=%m(-9@)hK*x7US6y_S&BWhi&)v5jiYZ2UHEf#v07tSusQT4fPWbdQiGFQl%A8~Dg zoQ1V4k5C>f>A;XGfzTAWM@@u$%4muVW@dTkS5*bRON#Ap5A+ce?_Nmh_9>DOD*)6s zNi$2Oj{mfSKTOgqY}^eR##-FVY4{cN-A&Trw@t5^2Hj!Yf8Y*r2JWzalhmXaP0B& zUr9B@dU#@vt&Jhhx5lHW%FH_pg8O1!z;q-?f#=^qVWQ%HVEmQ08Pwp;-A?vS$hI8D z-c_wipIIdkmX+fyH5BuHNEgxmM*sLCo(w}a$t)}XWO#OkBTO!n)SSl3g~C3nHbHL8 z`v<HVD1mn`2o-?wQ=NH~2q{Uk}s|PfCRA;o6 zu52p*{K@@_Pp}syg(t?=Z;}H4Tzb z=&u2my65GuA#}eMOOwQm6cv&-LLp?|W0s!B5?}NiT-qAf*r8yW>8g{D@YVpqLFY=; zE|Pgyx*8W{u*2Ah%INOpiNizzFCqtc&0L2U*?%FZkXr=BE_tMPFhN$#M|9dO3}eie zv-RLtS@zAaeTjEokzZ$SPk(NmxPkH{UrsTvVC68+=+tUh0)!_!E>g47K4RUGBL{MZ zknC|V;((E~H{0zHG1f1{S1!#t0DwwwEajb|)TMp%P3XVwXXI)^uFDm# z9gb|BbzfN-HG7av&$yRhO!ibNYEVinZk`*N?i@fL(x1tK1Y;9@K z+_W~)|Ix)0zum%u1DS6-DO7Ng%R5g;dXgr7c@H!Qr+GHn@d@j&r`Cj1ut?nE2qJa-qlW{U!dBC$; z|J!Omtg@abdR-L`s+!;1Ih)sb#-CEfOA~jZ&_{hA`KU8gfv$mD6Ppau zjRD!b5k^}+w7wc<4F@UH2;1s6hXZB48G8*2C24>Pn#$FNg`AQCTVWFe+Z9ZRUdHPn z$F@B_hwHlbtkjG3S(=XM-$GiVd5l`sLAe|qL}v4bCCF#aB*NrdZuUS8Nu(k}ed-d^ z*|>NeD0)5W0Bgd-*3&3-KdynEKU`gs>DQZW^)7VDvLD;r5-3MN0zj6e2#<;o z_n8FzN4okNM=^E>X>a;Ngc}-m6l&IO9HQH?p#!h;=C>xsvi{RWy9L`ToncSEKKvR5 zP{j;WHwO;0o>SB887C zg>=V&+3so@_xJ&R&a$AGp+4{xgbAYv^g+#60I+TNX-7M_D}35~CJSS-@v_6K$lWCT zd`9DVLXUQ1HzU<|wmBR`YuM5dCK~9W%Uaf&REN&O zz~q_hvm=*LyEbaNW8JNen5jq?yCJJmJEFrx5r>mzV~?tRbbOl%O^Wc_XySjJ6#?!C zyxW?3HUQMAP9!6f>2O@*dCrwQ_6LkA9@k55NISJMQUP24O$G z51R?bdypDG9#s8XpmfI`LHBK0eSvdnbN|J1RhrLU1ir4d=K$;I9Qf0E=9dvKP9HAJ z4YK~?ZQhn9%%pZhb4~wG#NuYBzDjBC+y?j}f8kF2Tvi69#2EQc;f!4}1?!&qY~j4T zY6JX{=Ol#&MU4%f$fkBNopO@!Jm3*qeXNW{Eq>*3BZ;M=$-T0;e9hJ=Vd0_cw;&d! zYM;rm>EnniYWWqzYjR33;pPO*EjG_3`VYtCe_4KEjEoxG0#)Cz_0`Gyf9gx~Be_$V z#Bq7>R70oYfNz=uA!L$FJ(r(?e~6;?ILtOrB%(D3t}nH1walF&YPy{%;7-n zeQ2kOTK5c>28CP>49p5?v?9I zi=5Et)HZ%rJ_Y{@R<(g)Tw6;3-L29w!}mpLozT%FQnpsjs>jjy=2uVjfVAE|l_-Y| zcX{eOg;aMH>}5oYfJap{iYkOl+dZ7;n(s{|RUDT4*~Nyu`nRKBoJfYflOJ$EL5cbV zjyFD!&03;9MCmdYE5tK5nk!;!>`UFcvsxNe2muyLaVD0&-;jeGuPPI14+ZWGT)g_VZPr`E%+3p&((fU znAf&ZJT2W^4K{40HQOr1@v$x>B&Kw7W2W=yStbuv`YYU807koLZ-ghulS_WV#fP+? zg%;=7-4yDz971dw3rM!3@%UUEDX`-ypLkic-0~FKhiNJ2>@f%}>d5~4d z?q#fNXmEVzsa;Ay)W#4-_Z=>Dbv(&-r|>BOIUE(zO%RsRw)`SMgT!x~$!S&Q0fWQS&-+ za_~s|n)J|G=rlI3spn#MRTZI(6n+scW-b1$LZv(61qiRm6EwdXA`jEa%#g8*>M zIAN%mNI~w)jpf!f6C+c#L9YT$9#4gs!%R&ONpmmL4v+p1d#FPF*4_x0oX{IfkpGSL zbHIjmxfDNnnD)S2e9TFWmf5rcR+#q($vW5AMYUBz1M+reW$wKY?&zo`#d!t8|Nkuj zCM45^B3nd>HjL5yXjF7jZz#5UVwf7h;HR;dK#3Vmq|Uuw?QpfJ4nfWSdV6l>I-oan!bQivY>UgAmFLs-Gsa6=c?OZHU~YhGhhfdI@MpCiLd z+Q6`m0WrbN)8>(}5=8Rp4?7N{Q)tZ+C;L6<#3nK5dGTM zKE!aQ2ImYITh)(T?y%k5Jk45GPn}BpHC!$B`R8+7)-h~9j>;?9qGB~R7zn^B(i(Pz z9(mJRzLDwf4lMB{c|bj63#ujIu>;UUMzbYr!?>{K*Gx`;lVd5XJLNs+B4LN7EP z$$j#LYh}hYB2C0ZHe15zdxB~kup`%`O|P8m@P}EM_#?^O?`0e(#@Hvq0qYJx*Cws++V$)6#cuEk}G}UbZd|8z@uIg@d)#qQQsG9C+4FnAWBUa zC^04WowQ`9opSq$=l>Bv8pgwx-RopUa>_{^vSLU;sC3T@2ri7Ez?dKDun`A~lL)Ht z5R2ccm`yva{L)<%&?9I$UR{yH9Gi2Q1OMeB~o2$D68eJryUp0W!k2KR_JO0v#?hv|T9^gP+Kz zuD+Wnc7~C`;*3(FhlbK4-nc#Q8r1-`{d~7G^U$gJSB@w_>&cJu&6|RtMY=!WZ@H-6 zPu`n5PbA7Ui|V%2QYNTDcfXo#w4T8E4;`$run_WNzL-TJFr_3Vwma!dcc(9{$Y}W+ zQO10M&vo7W=*T!0*`ebOz3!73Aam~+2QPJKG$g&+Ke zJgUs#A-&N-OM9nbczEE%k*+%5EOt6-=Qt7F#>h?L75k)>O)h3^LIEjyng}JP=hYNH zgq|q|FfO#>t1krJ-JsW9&_AHvDjm_Q2@OS|smjASor+ggyx}6^iemWD=&Ojui#&$b zs`h}Nsg0NhYieb*dxzG`E%~rx4r8ncO$Q(`f7;QqLE36$8`Lc}Y5S$PZv*p4tY({X)BB2%U0wc^ zzcCzM82|2=G2?q4$A-7yHyE3goD|LYi591RnSgRkP_1A+)=lZFF} z>TeBl%_-;G3L#6_#7}kA@(N8}rZlI^R2$w=KSDAa^f3CY^Ni{dmG7EESfux1-GVHG zgcresBcq^jzo9+*aZ*0VFj`XAz}^)#2ubu`sDfQ>p9(_<0!<2+6U9>ikE2~x*ZXVT zmhv<21NfDac<n%ZjTg@5v!0KIqTXP#0(Rg{qdbnw$IuB-(@&V7X_(l#IX+)JI>m~)hd%#S-@t}Z*rs21 z&M#o}IVUM~JqM=F6`1~AfD`TiL$0p<%{&b7?lxG@7O#EHX_9}VI+_9R%=a~qASi`) zt8`~|+po&q8B)miuQBg}TtF*FPvki5grBsCeshHIIP%K{@|pNe*IqEazf}t%E*at( zo5Zu#6{w~vOZvlxX1u^4!Af(pOmWkdZ)R#QPL+M(STeyZR~G|_;VAt8$rHCPbcyjD z9%|4`xT9Oox;VCc1wZsHj*!RS!X)E!nqV>WG{nz8a)oK_o~y{#p=qyqb3C7&DM4+sY=m9zDEd#*@TTT3#bM?zH~d` zV4C9Bnb_r@*&8;{0>1T)^El7VrYS$Ra$c2O`cmxd6{KAp>6ICnJy!KuNc|7Nl|~UO z=TD#Bi&(bv#dT#XX!!3kYZ!f^8eQ z`!@a&r9n-XnX4YJ^G#L`XhW3>^@nQtHo>Ge11l#yvyUf(P7A{_?^JW+f6gFq0NadX z9;XMEpglJKG*s{Gt89!vHfi(@%^0t>C;ljTTq8)sI>x*0tz;- z&p=m$d`72FsSRa?l%>yt={+;B+6!E5dLv^hmV!Ff-G!D!G9|s!*UMD)^rJV}w^H~F zHRbq-^PT9<1^&R5kq|MPL*rFM;ImKqifD<*wxLzsa#wUL#;Laf6HVCfiu6Db{fHb+Kdi{hm*m=z4vqtai=EBD};_x(4%;}C*x5;qH^OTyE;KyA(hTMEAlXxmf@lM$4szXQyhRHID zR^5%~_-u-+G9NY z6-8(CvriU7C&e!cutTCrzfC98wRUZ!+$z6U)XIVSV_7Z6P4TZB1TiGEMGrvT3uW=h9DSs5Fjt6PmbjDv&*S#S9ds`-~vu++!P&} z-&0NI4Rd4oz^hwrZ_*Js)ro8sb?eXN&4jP!S`VdhB{SXow=2B%{nqY07!IkngA(YW ztXi_DIQh9M$;gfV*GcwpoJ#r4={S%)QA;VO=7$eGg zz4h}+*EF>pZWXJO@FB#%mZ0qoP;m$cqU-uvV-T;Sk1oQNg5#PYQwj zCeaHc2uF;~h z!nPCd@~FE8Qfggl_=(KsbTF%3#O;^BoHXhARWgyKMk8nSk_*WPE=G8{lppdD?wBfx zh{E$8r}>kpn)6(KpxgnMG_qF`tpyc!tV7iW#?m(9tH`-!{gf>S~d>S=fcBw z{9Il!-1pDVh67Z^BE(iG9{lY_&qE(!%Gwv`NDEi` z&QD`0{e>Hx0Zwh2!@5G+_eA0n%cmpahY2ym{lUE)qVZ`*r|-3jVmS;uMg*gYq8l#1 zFUKF?qOQ&ri&XlFX&*QL9SBEFMTyEjqFS0tE(EXF4dXs%Se7H*;Uxh@A3~AtmzS;- zUx9zIOA|gWEEdN!o3V}!{<1}ZB;&4=vDCLg^G6K8o6pgXs72>j_j{EL7qj#vr$n+V zJ-S)pbiQhPB>CXJ-bT07_(i7lgxtYV$&Z=q^>T{Pr;KVSAAn7+-<5Cv6|L2@mI-u| zrKR@it!LOC_FG^;TvPmfv14fV0dL()bW`(rne<%As1!$o`=aXF&L0Lzaqg8zvH!35 z(8+=YJ>op-Gz1U7{>FM;vFB@3DO$Trx;?0GFQN?^@;$o@YYQ|b0T$_Y>fG4(KeybU zFXCOgJQkA%KsI3`!m}UJwL8l-@z1!Lp@tdu_LAviGd?}UZOghw#)(YE1ae%sjY?+8 zit5~FT-WGqEj@HVKjH3=LKEAh*89)i z@u}uq&phgD2bAL2z&T)}iVw&qj|1>cGgbHid&aHFdBcgU^&$K;89wLPrT<5<& z{s2^bGb7gF5N^4B@_36)0>h3U_^2E|?*&J2;1ru(?Ru1OQNwDk@s)Dobgfb%5<0m}bn49uXU20jGi}TI(&ew6 zES}u;mB%@_FNIs8T3wXuvIUd?Dl0FIzf_YLS%|zcz_e!8Qxw@ zXo)xO^`{+s#D{G+B^~v7bDS?XSWA5H`xZxv0V$3z`aFC7R=9u1bcl`jRYy;&;UQFp zV3f>@{vT~%#x@SUz!#{+Jd+A1l!h1T*c3eKzLsQ%8c$jae5b?5`5!|It6}dOe^tVE zkU>_QgqQ7ByPGZptOsQJ39YEsCmtpWx;{1KW`;GWc{UJAzCoG$)%M=LH4~dpyjnF) z$#YYUE7rAi-U6miA@csixEfT=r6IK!LSv$=CTn~q1Wwl)w&8SMCR;5v!15-lgTux` z)}@deK03;s&p!QX#-%l%oO~QQC`nQ_Lc5ACL!|c8hM0yPJ>!8FpQJ^mAQnEYCb90m z{?XqcNq&0SE_fp%0RpToh%O$6eD*Sn#01Bhk6;`xxGOXFO1dVT4V5(1P!{{5Af-c( zUq8Md1;~E;eWJ>4+Pj;w9!E~{fcDjR`L5}UurRs{k#6@#b;+M1L_2-m7N>CVN4hVN z3(>2BvF)R1bwDQ4hjmMqEy1}pyPh{hKsEv&3@x+kR{5pUkeVT>pzDR5eCF7t6Nef| z#I)HZCN=5%c(Yi4&QJCflWE#t|7Pd}uU&4VD}4-aUOP<7NXsSYWT3wNpBf$Gm{qmj zWHm7V8>Gtnh`B2pvti;>Pg=5ypt*HF4OC!Q^5}9erznJp?JP8TBPh!T8x`AQVSE6N zS`e-XTCp1k>_6@rKZEc32i|zDF#=ak7qhtMvoSdHGm)CIHkiY^12Mjailc(y0nwmRQ0~EW2F$ZeOvy8bygWGrBx8gY`+A zhQ6Lshu&+}YYwYZtxFfB1!5g0KZ&{$ch?w0ljOo04Qc201(6J&R~Nw<2-v`ed%Hv4 z&d*h60_>)z2n2{UyTJZs!{!3BS$1CRXQP&-d{JG1tmp1BhV7-!R5cW+Jo>K)LeOml zVTv;HDB^K|ercuJ@rDwB+%V=j7jLtQ1@FdG0rCD&DTM)D4r|}wyjB-Bk(c{{h5^?U z`#Y7dfdn)ec-;mnMp8p{g+w?|;_8^8chrRvp)lKXUNdkZFUsVE&AJG>s5t ztNIXvdFAK@hp?uoSGJBS8cKaNvln4AV7_vRB!*Vh4szSH%3 zAGHuMl`xRh$#L~C^r3(|P@w8bs7>whThT^7WKg@zRNjOrxOvoVjNJO-&voVFseZ`j1bJhBy?D`DtWQZq7|S0Cf^U2{!=9b1Xi zvUBC*#$5C_Yf}qIo3V;XR&+ad!H)Z6NQBD4b2xcw%JXr4U--6PiyQZerD++lS>I!0M|ynPs^SR?n31!Q*BJS`tKi5&ur7QGYMOl0H|bS$)^Ak4a;=r3RtR?^JaP|#8y<>3@ zP2Q$3%nSm`(Q|8Mk_{gaxG@p=`^J%3+oqLl!_aetyvc=XY2^-!Nl&iGcWaUc!3}>;X8zn75kcq)M3kM_i`F+2A;}_o z>U$`uqm(mD>W{5Uu>0?V+asr4+IgXVr`Jo`_TRs_>=uWxndb$vd|}OzXjA6+0uUuq zIR>C>ZHGAUu@GE3n`c}GR5n?+C5x`;ig0zd8{%NQKpns1#U?b?hEhgPx60SfCTEMF zuf;}h9f05d1mXw10{2P2*OVQ1F;HDbKVhiJm}tD5Z8gq;snXuLd{2e{n<;EoxOg#R zoOXnV;;jYOmiX!HADIyQZ!Yi6wqn#Oc9O-{JbM2qM%wxK{`Kt^Pv!MKKbXAX`6bm) z3>1X`k7nA68gH&7`XsTqDzvBJ&|N=ybM|tt3GXI+@0ev){jwilO0;-51H<~3Nc=$M z<~&9?IQ(44rFtp2Ok7lOT*^C17b((J2CVK{!Ec1 zAiv|t!ds}CT)^4*&};<@J0?OE2X9J8}S>Ff4r)3tg1@ zX*yk%j&4_;rym_bmeBX3_t%Rzi!Ii!77)Mr1p0++3G>}9NAucpk-BVkWgm8ju785S zThDwM)WtMNhz)d;JGy>m_*Av;MID>2F=rNmj$$*6J;3YUQtPi#US-&!Kcy6tWiapp z!ePV~jDmYghy~pm|E}_LSm2;?K0OV z&cz=|lva8>=&oY^kp1ngPZcaYIufWDZ+hm^#pbt|XVVjPXhUyobUBZ_&K@KG6TUg{ zEMajejLNsfDVP)zUh22A`L~!3D#|=qf7oa;1#?+sXguqyh?D|7Od?ts-}60Oe8fM) zO!L3-vl?#2Mh^KcB^(sNiPG`@19@jbF)q&Gfun*;wN;_|KTDbM>*Fd@k|?Cp7Hv*! ztZYWXArtc%iwDO(1;;N6iOE5#jgbK2k{4N;=a=_W3rs0@EhGY8+>MGaBZ-f$=wGoC zJNS9R#!UMP{**k50h_TRY8ptb&V>y1-&B%_aUrDN`H&sy8aY+lq1pFao8H(GKM5=) zLdH{6efw1Tbac5|Ba936`(Z6SX)=KV&^RHc#}M*!$B)b&$@TYCNRnFk>s2KnOxJz29wk70Q-x=Xz$6HV>!$^UC-mxuj&t<0KY7N3y z!uNxD8uL5IWgS1pu;p&S&VaSdwb7vR0JN)k=C3o#36Mm`zH4~Q*b8v|7&{`8!Nqqs zHT@du^wZY!x||dJ&}V@&S9l2v-5!3GjyMDa#Yu$UomAN*zA0(mtQI?w_^{222Z_h0 zzmy4f@z;C&#TZ{(gxvP56{;z0k1HotLSehGq)_>T=CBK)RI-69vY`8^KK{m1dlv9& z6Q0y<;w!%VP1Yo9|Lo*L zP)lP*l_MKsmjpcK3G*9IaS zK3y4q*T=a(RUJAHVON@+Kjk!>e|~_EbAu^h@E&nDi~;WYp_WE|Ka(kTfm4f$h&!oH z7OHuONx2#uHu52+<__^IfSIrAg4VG6e3g8v!8fsamR*0#KSZBC&w<1U@80EYlc+ij zqk1eFQt`Dlgt>5H$g2da42)V4zbu}ZI2x-bUA78(u~;5XNBaj}y7(CRyhOgobY z_nHAmIe*#w>%E)^!(-2x?&@J`C=%y~z(F}7zMMV%$Qf6*%2(PGat;-({}wCLe6|Opy4FsPZ9Tbb^ErBYNlkB}LS`QxwYP?K zlf}dsR`vj?=YhIvNLvtR57CbI`vT|=?PD9Sf{Y*I#wmW5Yx*S6#Y9hR&22satdV>Rqj z#A<4E@Lqy>gKd;O#}mA+575 z*Q1J9b_?i1Waz7mTd7ypZn3>v$HIH*ML3HZCamzSzPp zB{D7Ce<>w3>JeHo{x^|y!qw%?UR~opsRV2x5Az9NORpU2X{Nvkor zZY$vts%SjB-aauCh=Fg=)>!ljK!0_%m0AohH1z*M%OBCV29tv1vEHF5`Cv%+UqlZx zYF&x9eEKYhXIv3#d@ebW-oLR272p%L9fDm}Kv**hHsUK;vs@pW`R{joZEGAoi6)iU z{j!eb?NZL*z_PIgLcLMUIfb`3cEt-^BLA`RGIve(UE}US&hHkYC#eRqMhM3=y5_{Z zq@}<9ODjC%s6p63o9SirC0Qa;^`r!6UQ4??J|ATYhwOCzTP^n>9*|y zzAQiyP*G7*MVT-GiP0evBcudG8U^W)&TSW>q=0mc?jDWgKxw37!06b3(IdxT@3`(K z?)&|`&->Rt{ORfMJkI0z*75v&PKi`Lv+d+^i((h{tF=V2zdReS_LZQRk|B{ldsRZ$>HOI zG&i;U{$2-nJEmo3J|TjtznF-ew(=CB^|&6U(r#WxHbI#u#!IFwT(^se_gbQ`xE2wpU5-`=p^p@A^Jgd3O2(u@qug=}8+Q)HM_MYW#*U z>|jOrSzZ8n756R29Nl4Y(*x(9ehjciOA%oyul2NC`Zp4kJ5P=eT|I?2#MbwcU!D*x zks8;i!Q0DA>RckRIdc?lhr%+6*<#scT5L+E2FV*^WUEKDRrr1_EhTwe-NbMly{lGH z1|R0@rV1fY!RfCRDjKf25y06HqlOl6(L9Z`lXYk6c|kryCe;@^{mk4>!q| zpd1uLl4y8|)rEf~A!a$2&!ZjMgfprI3K-ez4P7l_rcmMs^6v|M>o z?W{Z6g2pZ-RCj1Q_PzV8l=KG3;5;iHs#g9dQSu?8Z=f~)te(i+bS~1*VR zL@3}3x7fAIXY4=D>EM9go~MNs%qj0 z$CHz>@IT~Nq)9jR+)&F50qJ3J+5TiX>RviHYz)aI3|vOh2O2qdQT(8L-AIySRwg)dqkP z1j1{PB4@;^`{ObdYQfz}?s;+R8{#r45Wv^ir$VB2txA-4%v_w!>KEIs?_5qnJWpY~ z`VO#ry1-bGtmW@sGPjs{6zp!IZd99Hv=MY=`KZ=4=?mmO`0qpXhvdu65q5lhwhbW7 zP1M~@)*^4EK9tHqbd1zW{a0FDY?&@_^SJ2n!KFgF3!gyK?fJWY0Q6cr12LlHT*>hY zyUk~@Wwfrz%!f~tB-H7sDHx!;fS6ni`2&3$eq3v^jc(jnA>{WdOH)dNi^NMMQ1U0~ zjsDbN;BPGq%=GKS$BZ(n` zFRqVYXtcE@3V{3-Z&%sbztHOhxl(BkC+#VoVj7`=>&o_E=$E8Q=($KqluxdHv`N}{-=gc@E9&;g0WSW$$FV_m ztqkYBYtkuq07{>2=HEQpRl7BPPCP=aes=DDxPayT-WX#{t2QXwec<)Gnp9*v_nE>b9_l~MAro9p{8z9pZF0@9vt_!?;qHI4NZQq z-ogs(^v|C1?y7=)91!Ch&8zk(dhc;9_Ry5v?hMC!uaENRO>zrV6{VFNoj_fE)1Fh3 zXJwD8>&aBf6~x&vVUV}C|HwlT3f8lQ-`(!v(;O{F`B#O3HGI|e?1Qsnipf+58?_Ng z8?qhAX8Oa*w(pMrCaGbVzpXngA_YHGo;Eu#Y5D@bE+teh1{c^?Uq9Ar_I)s>zBe$9 zUh7m?{kIqA(GS^l^UMDX>myVfHMmhH-;Z{y31vAKyIT-KAu%DPY|i}=nAB%KVyPJS1KUVy3-khE@Gm${{j zvRcHnM`xj+@M-($1+{eCvbWOizH%@`s)w3Y$4yUrj+2)ed!N^+x(&;7tr^LZl~%_Z z&M)>H_8R^Y*jY>xoMpP~?GWs7&GK$GHLaqLvcDEb^6;ZckTrQuFshyU8q96Lv~D}c z&1}(VP@i==iA@7Kd6%>m_riX827bM1X+C9u+b_A&jxlh5JI9YWd-wLVBzrway{RPH z*utAd$A8t`HTOMJ=S?=aCD8avR$0b@FJdg z5#f0Dw%TIH#B0E)eUj~T)#BOuiP7S#CB~P@+|E{3XCk1Bc*YP0HqV;l3uXQt$s?&U zsS=azfT#A#qAVXcnR7zTi|3$ZP$o&K{}D#v&HeM1o0OEgK~7T^h;R5#f=?v9hRcwl zXilpHE&Tm3W-#4IWTF}^R>c0ooMFvr$T3jpOraaN`)#{;rk?1|uSRvy*OT0gz*Xql zAY;vMHXIeQ7Bo$af5K)fcYNaE>6Urph9-@RH2q7FUIuzpmQ$Mjt8VuK3t27&$NDdg zo|dXVyR6Tndhs(B2Bm` z8~>6!wbcBR{V`+71cXyiecnD%LBx8bSyJ&u8mCUbovb~rpyCH^Mm06t7wtW)D7LZv z^ymRj(HLQ%d%sml{DiEMR?1^|4op83QMdmb+mGrcUAeCJhx6Oq3*?_U>+QOB-fc)C zr>m;yopJZUsUO4llx&^Qbx#r36=~|!Kh9hrJiC#2-ZG4k$}9!!jc#77@byti%My8< zR$_1=9q#V!O(iR4MQ4YgVr<)u0n_fqPiB%$85c#a#XxDh^~>;(95I>>vcIu-a=?3^ z%r!SV+gRDJvlm#t(evW99`VT#TFCQ007nfj>F2fQu^Jklbkz=bKfx${+)9!*7jm-s z$wV}FS(en|~neyl^GL909>UoDk0osoN|B#&zzy6IZwQ}KR zaXveeA}%Z@EJXmDeTQ-;>8T@1Pd;3@z~a>0Q+G<2z^PL?FbFxE|J)!ucr-@f*T6OK zS9Q_AZ>a7Ayx4!V{HE_OM&lRGL%g^0W&TDqh(x}cBCDE}xFap2b82An4qj{Bye4r{ z9itXBMYNL7*6r%*qnov@8j#H|Li695C`Cq-vl8r)?3UczrEmzuS@2cr-m|mYorkv8 zpCwD_2bHdWVHueF3EmyvjD9LKE|;m_n`&46wQ8)=YYuGxD~fj}O%e*Zhw?k7Wj>Y0 zv11k8rj&2@yMGa#9xaV#5)u3CU`RG{XuWhw6^6Ch-uloFq9bPv7nj;cJxchonf;BD zmuuF$3oSP5F}vnwi@FyPugeknPI@ov3vTo?#moCkkCe#SbrodgTw(O{9>~9mraobur!&Kerto7yGdbX?A^Kh!%4; zizSk?y=0dkRCC@M>~GI}?LHt06uwWss5*KVo^(O!F%`mrbxL8poQZ9<+i+e=V-!>% zrm6A`z#$u+efYlnUDh1lR}|}7x}IF(YV%8!yb9Tdhb&%cFe&26L)S=Wtzy&r|0RB# z=(sg;2O#v~>uEgOjPGt#D4FIjD*Y*en;+y1)l6nGZ1|Sd#v%32l*lpM);8+)Gi$1{ z#yJmoOcHHUD<4D1;ojRqyFL!w;$jhGu724ihJsTAJhG?#lz918@5Br&McIkiE0Jme7 zA3TkF%@hn7Gq=0DrZ<_ZEA$>r;Z5B$@^C^Dk0ieP2GZqmO0xWIub!)Q$uK%jMZb2I zQqt1Z9zI}T&_u`#HBw^c&f}J5Z%6&D__+Vu%VGWNg8g&FMHYFU%$4rF18jLY(76ru zUt=HJ8We{s9}jTST%L>mnW-`$q7y?}9xrlJ?o>hNm40=3 zhQS4$E^ax+V z#~Cm`E^?IM@~>KbQL^orE|3VVz~J1t6-hxcusU zuSlaP^5EH&YM;hf#*ybGlKEz;xHXqK!y4_g;$jZ)YuF~wTrU!NaVLvVQUD7R3WDod zU(dVttQ@lFqsAHHMwXxY6@v5^b*|Q!`wSFBZOWGPXfbNZaWCDD9Nsi0bJV`F8Gxi02aUaNt6O)_Z*7s&qg9{Q3EHvbWbj3I1}?2I%uK)Z;Q` zdb=Ew&ep#XGmsp6B-Z>rb>Dt=(f+hc$pR;~xAAGib_%V3W6B_ByLZ)NR7sS*gvTpt zF0?=kZVyn8qAAL1v{SXIIWL*aL%aT?SuvCSo45CI!$mGFEq|H}?07XP!(YV=&O7UL z~)8(78>D1qiW<~P26TFalPn=Pdn`OVXr$ykX_xo#DAQ6gv)L`(sf;L$> z@CDRh_nSJbnIQ7YWr0gm&EsYiD^NYk`O8Eed1pl?@3b$noBBaa)~+0! zLgJF|hFzfa|MPx}TsV|PG-%)gjF%wx#?-Gv|E|0m*XQ%4sB{DO$=`eL=~#hbUw72s z4~PFCTBF9FJbea)Uol_pEuguE{FbmnY7tJ{YF-Jrt9u3h<7Zp##L?XSd+?A0mfx=I z_M2j43M=4+j7pQDv1_bgcxg64Va@ZyrikdzLsOS_^n4-59W%6fT4f2!yZU~~*t(Uy z;$-B=t2RN}@VnZ+N?tY=N|B{`i%&0`q}uXCO>iL7SJKm8NZvktw^eJpcY{)m`*Y6k zOjwFZBiX0v#t-hlw{F~MQD}_skW#Xhog$j!mXY@(ehe7cM?SVnGib^nzM zzONF>9-*f{KR^F8;N|jBHsZK7;HeU;1gHPKeo%^Wrs_aYW4qiylsEi^kbmhM&d0!= zdC%Kj%&U)O}DfPF9L003o^Oh0wd4{1a0xetUA|96BZSOIzz9kBS7|q?&e_ z)bIQXp~Bwax-0+`sj}0*94~gecUkgey?6CE`+T^sL=SR77-o8!Xm-`Ly1gMUfJK!5 zJ;(?E9KZ}EWnM@)o7WhH_F*^7z(PNi<0JqBN?#Y#l@xB=dN)d0Ci0{Q-v6mP>fOC1!?^)0FW~f_#jI@zHVvn6UxWNyWZGWbw5IMUvq; z#5$p#9;;?dufr^Kk3MkD&gim0^21*Od6sD`n~Vna`b8LU(|Y!Ziax|Pu<`9yQ>)(y zsQUx@Z3TIS0(cW1CF(OJZO?|VL^n21JzXnm%r2>PDR)sb8{Zf);OcTn(jwAR{V}~t z)-k0-Hz{8iAv`;1kO?&V>Z!!EZM!8KaTmGX?U02*8$%Ap!YOb+%e^?In$8oOnVE*; zi$lwE4!Jq?0R4=YeSA9G>fO|jR$PA-_?fiMw_0i3L(5VcKC0|FO3r{rUxddo|<(`z@=-k1D#^R!aYJZZptv2q-{Q8NtP7;Q20fZ;YcmJ*xcz(V8bCx4IjgwhBVwTw8DE&5W#{% zSG2Ybja)ZH1LBXo+u}n1y-dHNr?NwRjV!xOF5S^otEJ?0z&Ssafb6L7XSMlSlPb53 zpR_*xlvh+mOM@L(vqqo>LjkQ*Pnv2{9v}{Qto`3v01l@{h|Rp}LWCW9w`@g;|W7^rmZ}vq>9eNQO?FhRd6Q#A2 ziuIxDvSrjC z&W|21;m^x9Zve-=$jKfZtS^%J?CMFa-9HU$`mq;=v>Gl)e+4z*WE*L&b$6WG&!0q+ zpH-_pAG-f<@98Vyi;GB;LdH2LQ>P5U-YyJqpR#^_K0kI z7s2*3opie;ylXCJj~;OkC61K4iGGZ8@6x`^5dDZ7c{GE23!Q+8l=zvwD!&S?Y;5rC zccC9+m>Vw*(o(7p?z-0yPZX+O( z`x;S4_)xuFNN&4f$U?hk+g&CQ0@Cdk!B=iSFpZE^j+jgf`biEJ&Wjdv50{Gghli~5 zSJt5Yc>T zw^-Fdum0vx`s6q|#G@IXzkY*@w1Vt1R0`{s0HK&8zq4*O_r-rwCvcJJO18!5ymRYc zmp1gSpx)m8t7)wYvv4SKjg_Heq_W%$JDw-jz_IeIgl0v)O6&00Ck5&{27ZfwO_2D6 zQFsd{&~O1#lXTo3j*;oVi0>>#w9<(gDcAzbDQfk}(&z~tc*g_zp8ErG1MO42O=&jj zsQ84l7>N35Mz*WV@H+PJ4VuTtxG-(3FHA=ldwSvwMh^Q`uGQ(@Fq-k`+1=)GPo7Z{ zao-QUfD-fN|DtTGMKp_D^Doumr>O(__!2KOGt$j^z-|bhuST#5G~p_5ZA!UQPPw&7 zn-w>n`t75_vXA=JnQzT7^8iWeSQu$V4SEa`KpC2>D}7&M;ea|sCoPfU>ypoWEE&>B z_<;l0j+gM|Y%X=c#IkyEzN%Un7)8|3QCb{5?xiLb9(vVqqV6Uf!ANW*_CEOhid*ob zBdOhRR1S=Y5f)E!7SdQ`={E#i1S?>b8|KF|B=!yb7AgI5BdguGPt`$Ez;{`t&Nf}UE zB1vC=`T6Fps3+{)qDo9ko6$M_6;!%GDmab0yLugAa0l+01T%jJ~okz(Q(vWl$()elWPgT3vCM|s zNVQo8ws+kYmeoUT;HnLPC{2zCRO8CM)`U4h7X2JPw_vG{rY_PvTn|)m*#R@8vMdOn zrIyv`U1iS2)ar^JD9hYQ& z73?%IITk*%9_kilBL-91&3dEl^YivEwrKTJuH){wyQuk{_-w&9FBkMZNdC1PfxzIB z@3jT)1UHLXQib2y_I>ZWdS|YQ>r{yF@i(BOA|YQ=ShzY&3%W3prj9w8yU)x_-hk$d zIbR9o(J7BQZ@WP=lgtQ|@@Q2gYxaQTEr@2<0KkMJtn}%(C)gjRtRk6>S1yqSC@G^u z7W5<&4(y-TSm`uqy^gBaV$kss+?mJ9yA&4Kn*Z-LJYD^2Pd@yDT{5j?Hx1$v7y5d? zE%vGXljf&m9M-rTgb=XE>2slZM<*=_u$t-vK#r>L@zTOFALR?QJ?X!6duZa$L(XBX z6&vR0NZRFsJ;B~ta=wWUfcrsOG=u-uL8$dv{pG+QHQS9^)3lG{OQhzB{Y3&-Za{7p zpH6?bgRRV5P3W!u$%3NZgH{fJa9mn><46w<>Fv;iBJva7wVd1)#0~x8}0#GLn_a>pF)O3p~enwC*zX@I->A0S;4Ht*8cZ(T}LPG z2mL(i1OcR$8pLBky?9g3B>V z5ecUx*x~H8iHf2|JesQawPKaS+}67nG-0D9ab6TpA9LQJqq}p*^pY86#7f(DaQ3es zPCKEA-4h)TzN>bqja|KYV})~(%fP+m-gBRitX#7in8@&_SC=l?X%szsVX&uo_Llt? z9eV`{mpZpaI_aOnI&Ih0Iv$<88(Z5xD{&+Py5OCXh9g2jK2L?vtwmf;RX-ZJv#}>v zd5&xWNFN5@X1j*m!;<7dc`BIcscFb(gtJETvV?@@&QSJur)M$edOQP0SC7{ zxaw?Xc2mTfoR>v&DRm-Wuv9QF$x5&%|B|TCgrWL~3g3>#UW_UYW;+J>9m)G1AvbLD z)o6b-&kcS>kl8wXczGjB5Nx)@{|0U7vZd2EYvj`qb{&KV<<3kG`UTD&kNQnB?ka_4 zChtU`dg?z?;npj`Bq!(O?LC*Nz5pED!9^A&gIFD=7et)vB1a|Gq6ijkKSj+)wAcvJ zi9LC(TKw`4h`-&w)vMZ$r5opMF?b!hux@lQE&Z_Nt2kIIzl}^CMa>@+W0N5`y#6}@ zSaF)~pTHMLFFNN?f~l+yqJ613_Do*-FbWf+rJMAH$f~^ExLo}`A#`q1aW~X;dV0A9 z(6dTSgB(l3_KP3U)Ma0sP!V{(TYb_fX=j)7T6dtdNB+sLucK4>L1Fsc-eKyS*RKhQ zaAb2^tmHQZDAVk}M_i6M4FU3&=8jXeMN+adP9|tBH6IdyQN-0yMi2a8>A} zA-3`SNPl`_kgcvQNi^T0NUCloFzCW>4SFiRIz5P-eG&PuSXEVqg8padf zZu=@Yvfrz_DT}{$Zw=DwJ>|!-cwXa|i^-JwKCyq8YhJRp)~D>-eQnG(VZYRqrmrMI zNO;ThXw@e**l+!w_FfJKYl8oxKkOW`5hRH(v{SiwRH@C~^J?iwShrh8B%Y4?BJ-8#IAp6|dg$8)Huo zC}Zp*0MGOSKN5uQj6QhxTe>;dW=gcGUt|`OLrZwtX&p?`g%N~B5tIuO0W4QHyw>T#uXP4~+GhJ0sK>t% zUuF{4{#d*v4S}v4AnXN6g0j#(g#D;0eVWvN|A$@dj^BU0vpQ!5PUAbkgXdcvp+4tI z0!z8C=jqvqukdNj`|*7d#z%`5*0{I$vsQ&RjmSAz_9k=q7Eo$k6DXz$YEBnyetL8= z4lRDFOJsXq2=L=*2x2GUt z%XN-q%p`8LCACgD#fXjw5H_00qh@|tAqlm%blD#bOlmls)2o_0AFmA|Mw}P1^c}ja z_lZk>+aZ{o*Y+8CAebMND$Et7ol3_N68vdsKrRdA!5#GlT0*-JTqLAgR+NPaGw92h z8KDO?#Ah)e%T5{`iAFBlb8`m!zn0?$&R~7<(xfyvb+eP2ONUn;C{GIW{Ug&+gt3g9 zS;Gl_rmWEacR-7tD^BzioJkzQ(mnOD8iP#u6t5 z@%10M@ks;tm%`eh)vVL^RYJrDuG1hpCIKfJO%7NZ>#2xx@%W=z+Xy&Mn#4{bMl0xSEM24eeu#Z|5apYxq3% z@a(9wXzRQ;NY(I`VKcVMZlFY6FS>kb<1j+pT_^&wVckb=^qVjSn=szf07ks7RC=q}PMdxW6$&J0+Xu1cMGp9X|Mc(>x=uro)JDsP7gaX3B+0sXYE^9dr_ zxi%njR^CUAV1nvn8p#3hQu`TnG~b#w@}L!lBac7bND3Ybdm|V9Hk62oFq!d~(T#d|XaN*5zT|x_Y0D@*)p)Ic7(it`Gmeo+#F_ z^R!h?v2-*3Y-^6I&F=H9iNukUw%4!1+*w}cBfrDYVUE1pmgB9{?Ec7KCCMJG906AL z`K>}>bmhlSJVvpsjaza|Ox`-JG>GGZt?NO(WIpXAUV5*P=Voq=(%-5vH2zZS&9fS$ zFw$w*46tB13-I#%B!}0r#&B1*Z#Y~)CE?}RY0lg^W{z8(U$H=deLu!Ob$kc2D(J?Q zN&#%lM}-^Ld(mRnWYRw{@Q?m>D59yfap3*-B~_6 zTPYDqS#nz2dnPNwSwjaLe^XNJ^)3tV+mGNtk#BHTJ_RbUF0z&StkF6-&8xF-X^!s* z|K2li@6!ycFkNb6F<4Y5Px|p;U@g*RRs5WdlqL;iDwEh9JQ5d;AmnzpZkL~C`q%e) zZD>rkMcnjZiG^kz%q2*B4K(yPE|Cc1Ls#svAAO!ZtW*mUW5`i#a=`W@W+Yvq zUxirq*9)CskELnTVs#Z+9QFkfBu7~YBEB|x?DVUGiJDE!*%y3&+6iL8ZQ^Ht<$?%&}E-FYB@7fTNzKh2T@PI<+e)u=A5 zS9G0j%!EG@dF;Z!d^0 zHI5#RsGoK3{Y3Up4lc}1r4NGpRGV_ah}e2!oo*b-zvsiRK&f5fz8QmUd#PjWHrv$b zEj5Oe^Q!gSj;aSod@qKE_b>g_|e$uoGkuSbKa0O$+Kha^NJ|U~r+q zZu4N4F15N`LU?OK%KP#8yV7fd32bLJoL&jN__BgsR77);*YJ_MTi{GD_^33=%;pAR zJGB!bJh06*3JWyK6Z;r8QE*%QE@W8l(QT1)s?}K0T~oUzf<3pY{)#qxl0{Y0sI3=> z4pe%d8}X@H)W+$T6}QNkv%^<4&-Jm7WK$W&!OU!JdS%PoUXCUjqY)Nud=JFasRcb& z3X`&JI$C6|pZ!(3J!Ur~P2LN1`{I55=Lhqxh1lSVFMNT2dKvKYvW-{-iZ2JttZb~BHiXQ$^_@!ZH9IW5qS?n1BjV{&x?e@#RrZg` z&CycL@*4;dBqH_%H^HhNlFu?}?gen~N{yE8_Wj_3&Ois2h6#D>4}pe99x&g4md(5$+40$}P~qkEVg{Ui|E=i$ zGN^Ici#84H^~}Fd0-MOefERnFCPo2z(%X?sQ9gl@PfR0rrKW8^L*3Vt>i2mQW*MGj z9~J(7-KBWYi*`#z2z0(-E9`N!U3z$6jY1LwDhd|(nA-6^y^b&LHm%PeRa^X~TX#db zrWhf6Ka_c~j&gEb4sN*~(4sE{QY*``sDt11YdjK~yw>gfUk6G4F&(2SK7Y1Wl*)gF z-Y=T%5-6cFyp`kEAcZVdx>A6CA1_Ukg+pfm0v+_Yv}+Sb(X+5JWqMuRVYT`yp{Nb! z{+lKnxIYIY+RIj4WsDqpH4@d4i?((MA!uBQ8yINX!S>j`o1X1FYT{BkAEgWv)n;QG zqqmKcwk??a*sQmbK>u+4q>2LKT6T=ABQW%cK6GF}sNNJ3YooKbse(&;=jgWmVw&Si z>z)704eh-b-rk5wjR7Avdl@0ze0V%hTEJ;zAMe>_(x&Cb!A})XiRATt9ewTkKZ(NexK@|m@F_SFrRf#uNf5tN4UvYM%CBF*~o&AK}ZKs>!F8*Xw-#=S< zeReWh>Ayd;|2?LQukZd{zlHwAFJFH2s$Ctwa;eGe9pcRzOKiYB8a}I%g=g@6jTH~+ z{nZ~CdkoTozAjlauA-lpHSmpClQG}Jk+ijbca7gfX=1y0lCI(2UIsuo2CUkxU#TtR z__?rdtzzS*^Q*D1sD`kEWh!+xa<|oH#2}<=cv!smH4xW6(w4(vweONxZwN>YuuGF9 zAQUWUBd!70TIBY{!OeQcbqDpZy`sK`=Ka(?WuBegu$#`-(W>e;t8VW?juu41eg{>{ zN_Hyj{GnFss_bW3`XT>Nic&0Z3+Ij9-L-u#j;}-D%2ChxmIDY)tp{!KxUgo0-JEwO z(h^c2M%!3AF=BTZ^O`IjGY{9?=-`p@kpR5Sdu(cAZY04q#T*J=+6GqSx;1lj4tE7R zZg1lsX#_UfyrNux`d_W6i-M__mskHo0i*vdzvL=>F;Rqtd1WTn-MJ+DcO~r`&>sR& zfeX$oGP0kkhq=q7%{MXhSUlF=DnG8QE<^SyEEi()d!S+vmtJFs)=yfN-7UGrRP2y9 zq$F^EU8;PI3r_nJIy}}uHtRJYW}6VZ2_pla540uR#*+(raXFmgs?oJ^E{rJyfzs8A z;S+;p;}-3;{RSsMj}sOV;wvxSs{W@#Zf}?Hq6Psbk1;1Lm$?k=Sy&m(2F1gqc)-P(8_hihm!OLf*8S-GMZvDxCndxpAO8$}n=6vluWg%0QGtB! z`KVIgRr!bgDxJj4-8VFoZUNy!Z$VXcyF^>#L5Z_9b?&`gV&I(i*k9!0%0CLpud^sx z+u6=1)n;mOM3Y}DCchTgk(PAz?U7|>IF%pjd>mn)X;TsN?`83hpA*$`M~8^(a2!?f z*3GOw^b+zi%pEdGYq!ysU^+)B-z8#cf4Z?pTsn!+;}n0fewN z##2j2fISk9ki_UFKXi|#J zJ@s9~PAYNzIys1hZr0Q{y^(3uUvmQ-jWVDk+`|*<7N_I}ZB7 zuI)4wZ`j7i;HJWxx?N#z{|-u6Q>)E{#E6kb5pW-z{g*iVQ6;%7V_L1=#*ojUC~;sf(h z47>%8U(G0A3r?lr;~#~m?bv-*RG@rD=k}@_AWAT$KOk7mW*$+Lo_Z0B8~0Y1>TE?D zw~}VuOc(0AfNY}jpeJE`#+Fs~F&n6_qDGY4cfS{;iD<6bTzL_0yi-EUAasW|#ixq8 zmF^n9;QFcg{$R7`+Ub@_sSn#`ZY!H+b}#1T2c99=E+0+1nD|Jww+??!I+pTud|%%BA*bN_eYlZeN3sH2&d&Rz zlF7RWI_SICc_V&fQ`6*tqrIV`k5zRt^kYkHBZFiin_VXTia#>nxia|nLDX3Rji+-x zY?O~7%;seAN^CgBKD%P*s=M@Vi|0X%9V4M+$gy93 zpwWEQE^KOhM!Ah}jzbnC1&bZeeCHoijG*CSItc=Ur*Bo0-dW+30iYVk8NTJX*Z)!R zE=KZyjhIBh`{O{wUED`w?t$ z0B9B`oIxYa3Yt8|-M8_^jY;=}3Hz9@Sl~9;b?5 zrN{mS$oB>PkZ%?Es8?hJvI^&pm>Wty9R>(TH1C)9fw#}(Tt*rk8NI}0@m8|3mNt#M z!muK*Ng9+&bpZvkNCRqeYJQKG$^E`8vo`rn0>+TuRgqFeyq6nRrr8(v|6q-!{(q11 zAycSpwMz+{@{+B#s#Z+WM;q_4=et7+(J$5`?_nj*mvL6;H_`UJZ$}JCdrTqvi0>a( ztF=w)aN*9SU57dLefQ!ei|SVQ^TGuER<^^`+J zS#Nk(GO(IBQo*oY!lC-rRxvbz$}W>k{iE8Kr(o{`wI;jt@MJ4eZ}Jtu01X0kw7VQo z0bO2FZCYSO{Qjw5ZCqN7FQ%0Ekpc1E7||#->l4Ow#@n)3b5n{%gdP258_z2uV+1Y@ z;`T;*Xg6R+13H#WK0{py!;^g`b5Iq0r*JhBW9`ga+H1Nl#)1B!QckFEeW{WRLh;f^ zJdn_}<0b5)8ao&nxv!Z2{(tacEkxFm$R_*`j zbtwF%C*CKhq)^XLUG4XtK2+#CE1*=jeI@&drrc?i$?QfagCzfG-e;C`4QHisuzKu^ zO_36>l_HbLe~?^T2ZD*R)?28J+PaHwC6ajW@Dqc{c;jMJe7r@yusCE(3L0lof=zc) zZ?s!&jKm!Zc-S4>mG!mbs+4&QNNN`Jd=_fC^oxECd|!GEM4H?7Ej!8Z>9^UM^>)nY zGi48?z*i-l=qHT0?cAnZW1;^j51D~TxZS~ero&^Qj_N+4n{bfL1Y0sY%b^&DHKh4| z{6eeglx^n5JWkuY)E{4sn|G>y5Wyh58RQjg78b=q*KKI9`#m4;d1A#%13^|5WbE1^ zkJtBlICrPI1_vEGN)JDOPRYv9Rcl{B$`93OR*)3<^HBFTH8~Wj?qkpUeGI)aBl2_RIUy_UkJJR2Df_|j|wD>pY?vhovWKg_`$+?s0v;up>_*GQyFPjd1VNin0 zaBhH2o`VqZN4FmxE@sw?xacIr?~R`mqNlrC_)1W{Gigwo*`hU*D{Ov;nOu z3ix)k$~=fP0hXSgu6I@O(iz*LK6HgM?`0IMtD1bo%D5eN`eo4-XN!5iSZYRZKSvDg z=||{wx=a;oYDJ=2M;p6)O>$AbgKPIBrUVP@^N%e;h-sr6>q+R@bPiNi%zOKum(7hN zgo2I8=Veo`%Ss5UkFsFYI%Pa7di8oJ?5F+8n0_-~%Ls6J#x8~e8dmr&>0r}s{bS_WKI9)9A*s_&6T^oq0d_)wMnWLQ9<|UNJ z3&tC|%Aa1HNW8&|1Y{C9g0Zz=;x41{@1IlCx%x(j%sU#y%nd??yHE>y4np2nMQ3y| z)&I}P{lBe~Y2+<(!!BPxRX6Siezh&FEAW14aEKBx0RG)mAYZVs;!p8FTPVq3HC;2p zuovrP17#gyah-MO$>%G$0(C3$hhoMba!H@7!!kw9PLeUrotutZkU0}j zgtd!RrK~Iy6a0gVKcn13!Oci{>p|I>cS}nFe=*%3)c<2KYAqmpWgRsBc^DHwA+#z> zS1hsMYKqRl#HpVl`cT+|xS5mL3s3x6naGG9}@SBY_jVRb0gF*^;*M%d99uj>78<1Pn#;z zJ)|zQReqd&6}{l5^T|NWf*^^MERKN1$Yf6#-iM_s$*7@!XFLx%L6+%jY| zED5(@pecV2{7&&usw-PA!mzS|XRqy^*u?ip^@skTWU_d1uyH4~Qz(KkEGj{#7Zv&it9?+XQICCn$y_6 zpK^lk)_L{{h|Mv|CfoI7J)Y^+SLP{IM~wYbwSqOAWfAM+kiDL| zkT#ZD*Q%gAJ(}=gy+5|^J7X+86P4X(SHB`tQBmPRqvqf#N}3Ev+^6+-uk#+-zm zr{S(p$Dc1!Gi(d}cnQ|ljoVLcWtRx?bAwPylBQDDHpLwEK<~EZk&$)S>h!kf&S*w` zfqIoXf^j!z)~R_bg01SeGO}EfWWVa0@WT4P+u#2IVgJ<(zq)9KFB@$bu5&2--Jz3i zz4Bs-bvDBlM1@C zdri_MnPI7WSJiNB^>V#>e4B|}-t{Z~u=Dc@z8nd`O7^C;8DUW0fvU^eUQbc`K3k#_ zoXOUUU)HTnQ(VGO-E!w@q>wF-*qOELhi0b*3L&2KiW80iJgaaxstK{cL~m!>9`-G$ z#5`V2{x-oDw%!XAZn6qdB`4c8FUxY==kf`Q5Zk*eHZhp)*9|N*M^|j_FFJ4O zUSH;6#~H zCe58Df(q)|bZljp|MxCvN#acw=Q?sMmNh<>d2>4RlYia{qWLh%c^D%keqKq2A(A?z)~n&98R;p-9wgHS<<0TYoHkQh0JNLesaB&Q(Vj2bB- zOmZL~4blx#%8(Fgkd7gp8!&2&8hMZF|J?WQ`Q6Xu@x0n`?A7+o^Hb;7b1f7;ZNAgu zWwhw)cW~qBiTct#{Vd~&PjT`aCec)95Z{R|f%F9Wg~7<7E;QT6?jhi)&V9h8pP}f* z7OTxnGu_I`ov+346QiByZ+C@ZJJuSh6U?q5j0TYLpg43myFJnVS8x#g0al=~_e z7A3o{P(S`*fU=#K=C5lx=r*J+axM?3KyCA{l%WnRr#%th^>-DQ-V(?-f$eBfCEkfz ztb2&

l@POFCf_-x&&SKBXGfT$Z6_n3+?~x=w6gy<8D%1bq@rg&s%tdKF8?+i4x zfIiqSOMEM^HrbTGhoGD>$0Y(*Pt)+8+r`bc4{@=ehrWWPVTdmZQ@tL#M5ofeQ{fHU zQlHZ(y{rFv&xic@c_#`0xCSqPX8C(W&U#hL#pf~>CmuhwZ)giGon62; zrMpotRz&AuMfRF}uRAArg+xXWwRtW_+DE$3j33tcFJ@RAcKZ`>PvIvtWoNq^x=$SK zNRr1`M-Z-IrxX5rGGTXxHjN?UMzO)~hpz$ydDOBo7VmmlUOSa4`@CyPH|l@AmE!hj z@?If&M~1^*OJf3rGts4$!~{Q|{PCJ?dAC;7-gTvbo5o(s9%is1Au?8T(DsT#0kRaQ zVM-Z@$N2V9dNr8Mc+RpLT~n6Nw!0)TE>piTwFe1FuBZ^>8TPmASD0$-u7AQ*X2_+S z2zq#}EpU9GHOG_IM@jC5$hgydL%8%Gf$NoX;F?{OYHRFq@t-1G>pffI!(>3?RuV>h0@#>E>Wy}kI96>>&u8kC=eY#88hSO;>JiHW(ut9{ z?Gvat^rQ^ss8vG;ZdiC4TPE?ubNms2$?NAk9>tw(Wbe~~;C{^B%#>BLO7bo0dXwe3 zsr8|o>)d+Z5CaZxVvlggW@U)L8#L5AwIIQYvcIPb;+MTz@$_yVzYmypfm4MN|4{k|-1yvH_2c^DAbkLd z~snM)04ParTIC6R_=;330`K`>;IF!Yi`-=szP87)u7DMl}nhOpJMHFLULab ztz5z|X(z;&fbt@_wL>mUL)Cz7;m&YSFl`nFOPPgg@1+cWLt83*Jj%A@bK_X4+F6s< z3TP*_Rhv&7=e!vSc366QB<8+$pQG-=QvkE!*OJLV9~g=Dt{4^OFMZcV>#LHzVVmDk z>uHhIcZ;w!?5;$9M^0jko3(>$gF1|JFKJU_{b%LLNzeb=KlNXAzrf}9rN%!$l39Tw z<%c~T6sokJ^nRtBy$7br(L|WqULO7E85o|MfVUADoD*mmeMw{;Q{H_og>rcBB{rR$ zw#E5(%q_EYb|yyJ+yjk3ZM)1tS>x!!vo^i;x4_;3lbyx(D`e_#b^qPbhj_tKR1Nd8 z_*mp_24xYH=6D9teKvahUGhYoSdQ|mv19U?<&>24cAS_vt^_z(mHIV-dS?6%Hnh0P z^b6y__@X>hTKgp4Mu_1!kBW)Uy4w`T{J7HqJ%jvdEl>ce3_jSU=$UgjQ^ehNdL>bI zJb*=-FfSqP;IF>+6?j!MX9cbW1yDkbA6tk8GM!i~uZ7KH{QBDJPx&CPZInRpuG*;Q`h?gvb*QYw$wR|s=`{svcS^3Pd_vU<}0kf{G% zMMhn|f0InGlt0#!#nhIP6=_i$axW7L=zjd~98L8FkMZBuHye($yMDB z6fWObknv=3>Co0LsjoM+YxZEV%Om`aA9QlG9ct@Mp4rA?_Z^SrlL0e?(bCXwryGVzocrwj zmM)JG?cW{w0CWp!lgsb)n#gKaKR#`Hej`rjLQH3MxDm!gg9swq{@FGcoX8lTs$p4;3by zPz_n8nhWww!9(w*xhdG%UZC1V-zY_Z_9&+{_W8xzHv(j- z$|~m`ykgOLm65w`Lm44#+IdZxPMI!_-6YmRKYKf-6e@i5D{F9vHNF|JT+~|B4Q+;j zp6eqQ7!dIwDp604?qFJe0MK=tIFRR&{?i*C1FChnH=FR2AeWn(n(S#m?zMwivN>&B zBfB`${YQj9=~WSI@{*^0wTb7n8@54qPZDS1rjB5{RThy{pR{tfqfAdrq`?Klwxj`< zlg>b`nm0cx8yU%#;^gg1p^$wQ7%$;w8ZFyWZr!X}!7f6?<$<)(Yx9P+5Yq0t6RVOEN(t*Wy-m6GT)~MGY zW&D|rGnR3W^Xe&WleF+u6kIM1+;rT;&A;|f`{lq}#3P`5VhT^MTi})(M^P$LhL68% zuzk|E!Za(Q?oVaD(yQ|^=#b^OkwAX|Nz2Bc=q_*H=hOz0khFGEuuf1w@)$gt_FFH(anAOT9M1kr%R_e z6P1l?aCsCDtvBqrZikqH96z!#BOCmtMiTa9z&>5py4w7IA_)}Fan5=u&I?2HcPij> zxf|XkL%igW1>ah*2Zb(t>DCKNRKOwXG9)A}fkM1u;Loq4kw)NA5=Wly<+N^F2IzWV zl|dtZB|nq(wu}>kamy`_ua({mu}2vmbvIzUlSemfjwMNdLemd3r5Wgb52k zpU37&Li}x|hmX`YPu8)^Gmw5=NmLI_+Sr}=<(%$#SE#*Jg?#OLYR{?c*~VDidi{;f zyZB@?6AUWSa5g0Ku2A8Ljs=9UqQ^1i3h>>T`^xv-!g znbuXmEe+IEL)G@o?UfzZSCM}x1ftJHd*y~h^d9=I)9hAx@S27xOHhf6DJT5VP?XA; z#wqi~`3#%1CcPmISvQ5EUNQboIkT4|Q*cDYJe7+bgNi&hoyX=Lq{e&3U9 zJj`nxm^@yh6F;@#m*9F-7?SB|bAZop*=(2{i_!HG9Q{6n&_;0S#=HJ9IPqQs$d-Cc z`_>){4v|kKU1DM5W>)st{KaAb%R2oVV;IC`sUcRVt72qlTak_n`oz?IvFC9?>iA2= z?1}|}E~Hd`udnn;^d30AX|@{K@u!`l{0|^rvB4Q&ZUy)rZCHJ+hT5j=)~q)ZUj{mv za%$6fk?2@G_OW%B0HRINnKl!+*1OE!By z@@}a;2ea57M^e2@O-+L=i`Tma3LqMdz{F2$n>=d`Zn2S&^gLmR)r!NL&Xpei`dbr~&uwD`np zEh)*!?@aG$QvTgOrFLDJs2N*S!B#*dQLud7?GxGK?ec%bZKN||%r_u?P zpq_zp--9;%!?#Dxinb8K;iyl4&to*>Lj5=obkO#Ytbitzw;b-9kKQvoCYf{vjc2?s zr?jf-E*qimp)5wj zY>*mAX*eQPcyIp$SFvLY`>kypy}fqV@H}1-H@ps-c7wPLt1{0()lK@Bk~X`K&I-}{zWyUV_GeQYkWc%1>Je@!ZI@pdaklr6 zJlS$P1%dM&AbX=$)KP?YId`{2Z)sJv6h;;*#9O}o+b(eY^RVjr$2nyJeUPwwX`Ge! z$)|5A%7xkg_j33jcJRj|&U1+DOM(-Kk7nmM_v3Zy)GgHz))3l{o5U}dmgRQca38|i<=GK{m|V29Ecv1K)O^pG_OBKJrB0~2weNV@ERgkhjPgoxM5Eu1aSsmS_6)u= z+pOjmn76yv6AqH^=GZ{Pgi^!5L9O2+`n7qk?q z%(>Kw;<^UsQ>g7SaTY@to;r}6sjF%W8JxYDL(+{%)O;e;Cy@FEnG^xceOumH z?dCnJ4bs{BM{OrH@&g=-wukwOqZd-*S&2&DeI#5opxI=-F!(;~puu3bMTMPZ8mYee zuebQ^|Ih=H7k4mI)e73(_Szt2MYAD*Nel}Nq6dUV8u*SRT!|QQMoePy{oqu=;%^3l zq#{3GhM6U%i>=bxZAdpoTSB0C&@4{?>5EyQmyqj0WY(}mFVFY~0wM) z0ZTqA3B^>WX*`oQs`F(VE%I9#;ej!mCJ zpc=^twvA-*QQzl6x-O^gV^eX<2VY;S8o`DP-Laair;Cv;@!mgnTD#UHP}=I-wI*P% zeAh+i)E$xw$P$pC0k&81J*m;KLl{J zf~mC*0qW9Lq0{|A+&BMsF92dG_S_%Y6)@u*sQ6@TdA3@6+31sc*|$M$K)kU}VvFdG zYeyoZBkabS?1Pcq#XG8T2T7!~tgyey6=y@pq9^dqk?)F3TqJdBo1~Dwh%Y*uhsSSO z3FH0X8q7HpPp8L(!Wcb%1Y;T9-$DIgo}J@BA*kCp9}_7#=_+Q zaGOujGXMv3!MI%h9+2tF$~UgjH#uPhpD5*!8)X4>;;W%UKcHa3HWJyjfw*V;7*}<9 zUA{$Oipn^9!N*2og_{Pu1w!;JtSz>|Dvr6b0vTIX)Oj0(vb5Dr=gQ}VPg*jLie1Y1 z)B&uxbx0#A4%7G*LCz;Qrup|=t9AYM6{>gcN0M;#+H{QPk$N+0O`USQLbGBtnz4wI zCWgC6kpzSg2x*KWuk05D`K+K3|seVtegOO0FTXtx{ zN-TXnPL-;pbwPOCGM@eWPzPh4+aZ$WWmunak)e!f@YBKlpQUH#R4LKu%v((S^`B_X zkbobvP)lgIX=RtvtIE4hqYIS&Q*2jva$h`9yFK!&!lKM&SE7;IvdF6?W!kBTvZ||w z+q904if-5F7juD6|JJrVnv|w%zm=Jv=DzCfU4=S)OAL@d_2{P= z(yRDDY7s~A+jiIJKok~B*!A=&=c8mJWd2&O{RuBaatry5Pf9s$omMmvY9$*o5To$4 zDW9#rnHis@QrRx<_r0_ImYb#ZJ?Ew$vTx=S{Ictd;9v>i`TpEsN}c0prM}kE-HK{v za@FNW*4|wRV3L0iXK7Ev1eYY!L*JjX6UeLwxLV%2zCP_{Z`Rr;;wENqmTQhU4tGfN zRIPNOCJd>o!ANz3?z%N+$SS_*ig$R?NY>HTjw;qkc=ThQ(7$g?sit#foqp||IXapC zZ(8b^uWo398f}t&xlMhM|GcgJBe59PA@LtusY+(r5tHh+((|=Zc^SV}Vo3?tn1L&E z%H@j2NT5XPPqVP$^{svg?DxW*Hr(0*A?Ogi43@7=0@f}!Po`P2LVdCq2f&A~%6bF< z6!N^~W3tlI_zs)xi93BG7?U9*mw{V7=lX|))XpM#U?gdU*lg}O>KpLO`0{wbzT`=J z8HaVE!EDfg?XzV8X>6-%EZXSXi!>6r5j*gMyK7Rz zu65w-%6>%eScjg5G}%7+Z_4@o|5HB6>0R8YgTp%WC|Aj;8y;+0O@Tu2Q;H$LEAdt* z7|kxLhzAVP`rreP`%PU|kwuMge8-#&uH2hd<~Rz3B#v>$0cB9pz2?~aU0w2vThepo ztv(-ZC7?if4cP@fv=~Eos)3Dp-kVUAyMMrfQZI*efU@(-Vd(t=Wt|x@d#8VV01#3q z6m*7BlZ=a?F&S9U0kGS-^6rIv7rGC116y`4-9)y9337j^UAbya z!)p;XcKsRr+?TamoM<{1x35o^P>5nem`YJ^$h#x#KG0QTMLdcSRQgiyR2eC(^TMt- z3ocKN=wt##bsF%X1Q@9x1`(Z6O7@?-)}tMRsrmj;c87&MOe-(1!9esNsuv?Cz4PCA zpBss~4SQL7z{;F1_ww_im(+xlOgYQNc)?U?W1eaAoJg7Z&(Be;*1uGHnQ(r+-B9UW zg+5lYlXw^L0q*ZPpWluPlW2{)=I?Wt%YP^4c_b6P`7t=2cz`+nVh!=+1>NyhcZnc! zs56+HvIq&p!@Mwt>P(iFfr?C!-^`q16 zG*M>;yl`HsI_ztqmAP`oERzQFWs~xwhQk>~pO`;cH{L&ll$Sqbl#Q?TyL>IZ<6-dU_3O~sZ$}1@gTSBxf)sTW(OJ>Gn{Rnke4ZDt(M+Hq}A}O#7Xu^Pg zKmh>9`W$2dpRG?@Dn3N8bL3a!k0Z3z44K&R4q~J zGW|$fYdhp{4m+A-*d>r(D!pHb{T2325@%HNJ>^?QVCU{|8?JFHJt<7sOC_;=p$NSD z==ZNEF_{a-?(%B^qfTKmqO);h$gdbv{rLb87^u=+emO|oBc7QMEc7UHIheih~clt5K z2J1!n9eEZ^H02|ufu5R=~QQVRg^R`m^qw#Hm)=q<|@HVbQm^x59V_nDwInlTBN^i&}I4 zuVD2LuX}QWzb3BeWH@**KhLO;hO)}=di4bfX_0nlwiS+!b4LVF!8UhzVr!!~&1v^z zP!dv1bU<|D7n`f;-;R#4=iU*c{a8jxnD20d#SHmb%yap{1Hd}I7F8U9T7Ne2G^H2Y zug%uy)mzz}$c|b*JOl+J`MVm*xSkx*;bT}4D=z_c`DM?xixs79vvT**cTvSg!y&Y2 z)I2%Wrm+JGr9<07N@E&*e4{9gW68}EXYzO$85$oaUSnAgMM=1f=9?(y2T@lk61kaxj63l4td}B{ zR~dx~H=(f8O-NSwjQ82Mq^7#iU36y-;?QnT)jPJ6xuE?fXDX#jwgWv>{Wv?>oi|tt zcMEEge}t}=U~Je>WzRqQpeh_n6KelP=q$oIVw@T?HhL;)+5L6sTKd_aE}9SLC*ub_ zISkn2A0P3@7{!*v&$h1ycBs|(kG%@!8N@!IdW0Q6NzWuZzI&}jo1R`Bl8JKt>1rzx zPoh+NRB!WG%5C>0v7hIoT&ec=lw zW+C(bgiSD(OL!Qbl?8c&b@`20Yf;!$LeZfHVjzxw-O1h3Ea^wXg8#$;w-5RDF}X;S zC%a^z9E&kTm$ZqMLIsbPymS+=E);m^NAhPGC6K8>z{4qTC$mCf}H~a@?^bSCgNIGs& zSi*sw@e1AJ6JAWep7}0^!2})>njyEAlBgw;Ya@6T3qFR+6nv60!r3Zp?lvpxn`MuI z7{OJ!oN42Aw61KI09KYv7UJo_+Dqm_Sf@m4lOorHo!>c@X$g8>39V@6hk)l}X>aJE43uA1>fVxuDr^-GdNsCA}Himi}e_bj5)v~V6 z(dO~@y)?NG{Qv*A0{DiMS$prcP1F$`km+ert}e4UTgj84tg}l(wKrrw@Bn)rEPpto z4owK8Oy(uFx*mAmmzh@@Xg%2dChr-q5=ZtFsM zYWntv93I;EjoFHT*iNfu7H90YTD*Oq`hXkD@}Mwm@i7IhgNt#5C2i}nuC5-;TaBFY zllw;MZamf^p6)l4*>i8&nz*b#OHP&TRd~dXC8OACw!fRL;LKNt@DE0le#y*Qs z9Y(I!(w=_50fXnKNdJKd`j4HFj9_U25U;H*4HFiFC0(sJwFnMe(nD20F zRa06Pr-dYogD(vUoLxhs71Mqu@x)&OQ#Ec2?L|#8h^v&poZ`SEMi+H>2^y=6=DzAn zdNBiLLpr{-PnnGus>kN#x>Zy`TL~Z0%83Ae;kEX=*!B?@TjG4CrHK|qhMde|XDQF+ z)xIU|D>tT8?(LJ_AdJKrUW3y3#v0VqVh~fyouJ;^z99<2{KhjsuPBNuk z%Jmz?F#w#&<~V{Xqq*s|k&^Nx!drezLC0au7%in_SAcZFjO{jQ zKvtK!f(*q2MUiWzfgWY%B^G%h$8t!0v$%SfX@rzarGF5~3#aqm@Y=w-GDcqd!mZaM`kZkT+rO5|Uehv3mBzd$JML%4n(di)UYi zG~0jd&PQ7sSGahA5ubnQH=97l2hKc17%XN1x;Gm zaT*}ir5UqU8siw7)eDyvZmgzuQHTpO=vT;M*B3eXVEGwNcDC#|GncFlVQK8FwfOKrmaT?Y5adu|6uxh_Ui>sUlMein(P+nvo~J;(@r z3R^H%EymsO&!ic>xa*cd1ZB{-GV;rR^Jev_dL|^Z0W^jajQro+e3(PGk9@w^t~QKU zEG0!OchK!-$9Rr%%FkysG(2S=nXCSQVd-z()zM1%!VlxYkD6u!^(8$YwHLFjDb01_ z;9gh1Wua<$yMt}&FPMV_>mR^cA?p7R6Vw5^#ubfV51oB;RZc1`SEm0{w| zFgCQ0M%_XH zcdN%L>-kyX4H_;Fk>O&O*`cY$NO4V-8O5gX!wk8NWE0~em`uq~!R@<<7JrrFzb>+N z3WWCJoYG#RnoP3D>tJcmXK1TSIqh*G%*%7N1+#GExw^%){VF-mOOCxrI-z}+t+C5? zqLt@7O#LsDnv#8vH=lUDhU>S}1x$0tvDEn#*Xj3S?)(C{{8C+@)^FI#9Lt(E_xa3@ ztDBIU_RW^RL1`PJV>=KvjR~5zZ*|^6O&HI#i)}tmVM(fmefGVQz28HDlgou}Lbir_ z!_KOzKE>A_T6GB4-L>Ex3rgq_YCA;ZbR;D-F{t7zb|Ok(DzELi+vTpm5hPBY^ z|FJFH3NWZFuzgX|44d8qwf4)duUg%BDEuI$or>Qu!o&C?gW<5_i$pI@-TDT|Rb+Z}oQ$Fa} z_RBRHq-5gKm<@mjPxy*iRpIx5{C%yH11i)F8ple6kYV3)#N>T2VKH21FTZGs2bwK% zn^}J8kzTjq&@L&9arc;0niAuT=+s z<=G$6fkjEL3iULDxGN=F#rYyctg1LwznhkapqlOHLy)z`<;$J)<~zwDrC-}>_Vh7I zU?QgnVz@tBdWw(i%Hp_Q;F4viJYJyqGEf^E`DAO(&x3i|^gY|b6S;R8q%_|9w%13- zQ`GAzzg%cfd)OX{UJPY_s@AcgXycR8HDk85os_wU@*(R)Y%-IU{vRh11 zIy#nPB=IbL^gUzTS6le>Up>11vnYQ&L7f}5cjBcOYi?Wy`z)Srdqs^KDMkpgL}F{k z^)wMCEM^+ttoawMROzZKR9=#<(?vKhCk`z|zfV>YDOIs^P9@$?l`fPn87OKF#8nJ5 zDSZNr)M{fHN_-e=N#&h=W-`c63Nsb2YSJ*BdDFZm`0Y(LpG}z{K+T7D3!h&(edJ9$ z?x6Ta3*Gksu159R1~3Nk;9frMG4Y4K-PY2}c2-||y5u}S$Lz1^s$RYyE1|hgm`_AX zb8}m<(Xx`)q}O7Hcd#>ItAq;oQMB|hbV|>inOC@#MzRr1{hhv$$ zakI4&EG*Nu&mg~TL%TRiCSW~~_ z%avt|MdQpi<;LfQ^AJi#zAvnhHbE z!>3?U#`_^9#Yp!R+X$IsrENb;b;hWKdQ2_^t9&7CyGQ_eu!kbv=wWy4izHMyT!s`d`w_^$s( zV4_pd(Uv)j47x&)Y6Ll=;vr}VW+!cYOU}_wwm2GPt5i=v{g+deyo!H32{~WBvGE|r z>VeCX2wa2c(j~?<{gGkq^hy!M<}%wzedTfmJ)+2dX;UzeKu(^7C~{MtSY#CT;d4!P z3hAd*iUZI;@;auAfkyE9jpvFwP{)+(fk(Rd8=Lr5!@n9@ROHu|dxT9xx-D`E>|y)4 z-P&bl)V)7H(2?^0K32+7Zx}N(>IsI1E6iwq_lwz}D=P}4qb6!LCQngrGEAFcn_~3D zN4ePCdu}a>p3Qps9Zk##m1UAUDJK3wGL;%QFSY4Uu3DTVUkyl=RfXMJR4ZyQZBMII zh#3UD{q#YFIhJ%+_k&NrVQ7Iq_ANgn_=(XTn%v`plguECN-S5^Cdu#aYGU`L$^95{ z9w+y~Zq!Tj24P<@F#nR0K1tfCZ;yaAc_fviXon%Xsm6x1CzlokM7AN-&F_^ z60NV{?5Vuq^6g~v>obhnl~B+o1E$ikclckGl>dq+2jBg&`3#l_P6w@W%j$tYAZd+; z-!E|9>ZyF(`GFn5@-$0W%Oyik$WwD|uvsx@=;3Xy+j1309awbv4ehMu4jy#d_eiFJ zhB^2?X=f$zTA>jq>1XvuQUgbUJYm7dDLGkch;_O+_ky9G+tk5GzNtWj$&&MZ+YFv} zk#0`HR%%=Q({4IWAq`y$?7TId7!nh}d|o+3kQBhe9^B2u=&($yf^&s^3lBu*O25Ddw-Iv?@}4n z1@UAXw0E*D2dYVaQ zYE@*>N}ZCC?W6Hj^~WvW?@x(0o8?>IiwB*VamqW~KcJWIg=%-(_~fPqf;{QH`|B*G zAo4O+bI0CHEx8(CHq7grE1GxqX!kN5% zdZiDv1er^s``D7w;j8m{?5_M{{k7rytEUIQ!uaKZW$idsl!MjA-$HchE(Vp2zUy;e zOS*e(VBS)(l0pA|cg|i^A&cGWvtjW$j_enQ?Y!nouXV#lgdC-9u|G|-YLo6r{2fRi zA#VR{pW5+FAHuS1Iqxp(nRw zSBkGr>DX)m-P2S}izFtLpMgO)US>%lSd=IBh)o}dX9fG@|8A%%k;XeuWD$)1T==L5HkT)6OW<0=(4T%=m#-3i@)#r{;OT)W&r3st7Q9^ zup<569J6W#A38K*_*v9mL=FKHx9?biPQ8-+lTcntM=VwcFR!pY3ulP&+^zx2%$qky zs)?^gWf&{mvS3Mn`cn56ymkCdo`YvTPYcykll@litDDkSp@AMP4+^(vsP%1=nFcJy zyJf6$YvdD0oIlbUeLiSaqggrn64$ek8gDN~H+oTMIMjq}5dhkO_^A(GQ8DJ@Ru<}o zS~(QkvD-(Fz`*qI9vTVouQt~Fgd$WeEZhxnEM6ttcfWkND1nTKzIji3Z|MJ4@-W{1 z!`+qn4-WTQf=|H}XLoWckuGtK#rDZ_mDDF(8v%j)eK!Y5ZEXqE%T`ewvO$|SY33QU z?E-VNJbh(+@r=Ya*6PUvPsqv^7Z1Z(#OL9Ma?T}VX7 zV64YFP2=8MM)GE%&;)_u&1;^TQ=1ynrU0Vc=U!{RU4&dH*Yqx^;r7h8ru(pcB+|>z z)dWf0@UHQt85!VIO_K8#vLibmS8^BsFxf%>K!uHuxObRq=lCvuctlT=M&io+q%jd~ zznJQ>YCQnvANp&Dd-g{+;7xCLI5nGEUFJ$<7V@UBw8Y$2$YD~r`mp?Bnbwz-;1~46 zal?YP#oZXbWU?nSWPdkGc>JD6kLIX$?8(^y_L9kz@B7T0p+o)0aV1NoGOKCDlko@d z0?bzGCT>xrWo|7GWTYzlfytVcDbPxmGTL%~r|Z=~ZP;=9SJ^Oo_Wmr|W=a?gG^a z%dm+yzV@NYJ%&W_^dgN)USAjQRWZq{JPZuVCwBej>3)%F`8G`A*S_zHfXjb1dj7A1 zR**ar(ccvAKA^hj>U7Yw2jXDekQw}(iO@@Y7Ey{sRh4D1ENEXb)Er=?rcHt&3YwFx zmk;yvLLq5X@~$73pwxRH%?AN(yH8Q-V83XT@+{-7oT%-)`P=3@+L|^Ws(7Rv9w;S# zNt%}A-vX%GO1F_10hrgbmn8_NQPSg4=FRe2B&8{--*EoTDo$*QgahZXsr^SbMo*Zm zh)FtrE2tI*L^%T2!|)C1AgT?ZFR+DJpHF(>Iy}$qYEb4sX*qJ7a40SeSMBmyj#fUY z9o{*w3?L!Zi+|n=|Fi_y8^ry@MZBH%-N+Iz9X@6m`YWbULeWM|s1MWvwK^R5p{>qh zzUaaB^|5bhQV)DCEWKM3Y0v$%atK46mbpB@hgj?km|n2p=az~oldv2P>eu3|R-Is| zaMY2SVXQ5T2yJ)+l4DAa!1tZprI+E|(EOAp#S7_(;XVDOnYEbzTm53{Dn>@1%GN!# zjN-d%H52);kKq}dW;!daiNUvWhHalXrMAED9DN^hn7vQ8r#tX9?c+C>z8I)GHZqoF zfXpNe3^ai&h_%hVpZ`sy=9kSV7R#N?8h3sp<0_C zMyOB)wyM-GGIg_>APg9+^B-h z0j8RxnWQ5}L;fY(EzQkweX7u`Zh*CTw~dUQua5TaZyS` zm!Q0zhuBsqxufhrIvD=Bn*8s?Z1$v|8$z3EGdyX&Y~hW`T<7vV7PBa2lG9mqw>jyK ztgvzHtxXvM&-Q1(Wv>!*Q@<&okH_aCJ`1OGnxLdeJot^If}47=+oZ>DY(-TN*Ej9e zfSZam%hBc@4F{+qtJeS`4E0aNN^6ibgkz$PohT*53?_D&+sD zE#4ax@$g$#V4J5;XTW`bPhRPd?23QceQv+sw$d=*L1mMhsK24$!spnxKUh}n+1Td0 z`(pRk3h{I0r2`)=v2^Y2uuPBC9Dr#URQBwXy&-bvk504jb8xji(pT*$bwOJ)x!#%E zBt5MyNwQ=3uPjaOdZIz`(bG1QtO3kPtL*{n;vL%BdFjK=4^x=64FeCO#tF-%BW(0E z?r*YZc(RxX-P-qVLC_It=rDajmZ{M%KH`($Q|C!-gY(Pp(VllFg7l;f%J5x#ZPD0K z2Jf>#TV%3naI_tmzBX^XVY)LlcSNxsUi8Y8b}DN!?7o)!=k-SO;G;J2fn`xY{%YTJZG8eQn}Kw9Cr%ym2Z2NUT;Lce^(^%;yZ$A3_!m9D zgm|?KqANEEtFsWU!mK8ad5zC%@jN-mELtK;;X+n&ifKYQJ@1sowH+_Qee3*)r2*1Z zu1OJB_g^y zKL`IN>FCuANQNPLgeCpmhrUZb)6a=4a3&tvmaQ)0l`VYMb_fLwlSS4F-w^6KN6D|{B`*vl z+o@Ax-+h$mTDHs{|L{utr(#wqmeH31HiVc?^el-!x@Pd?hnss0zUI^cCII#0B^kM! zxOe)UA&h%tY%2#){)<^XhW`74IngEK4kyPYJps*h;$??9dX8k;j3!uazYymAciYKz zygORh0`wLx|EP10h^B4m|H3U-UgPw}I+aVFkb*pGBn)AWR z$Q`j0^ZF!%>9Nd$4VjWV9pe2~y#pOF0uq=xsyHBc*ex0*D)KAne&edfNwFHOw!~-= zTK)P`72w8(-e$SpiiyB7v* z?>FMLyd2mAoN?9O&kmLVeYH1sNblAEJy~;d%{#2GN*cG0^ZcpjJnVa`5knMGA$e`U z%GAK1Oyr^54c{oTxjxacBkvY?6!#G*D&BTm`gm`pp}*hvi|fY0*)&7@G0(qmQmM{= zB=h47xNY?Z7p*7@*Z5eh#M`VgpKL6|4Xz(3baKgKniQu@hDfa2Y|P?opIx@x=x5zs z$+gR6DS7TUiq9KF6pTy5l*22PXF#2Er`vd8NLNy~o3leBW2U{_8=HVb)Xnm z*yJ4`s7!umnoitfs(QON6;Rrkfj-EzjI9K@TJ2Z>UUkWd>Hudv`1DAr>|Ge1@J=;j zjhwgpEOomf14sAd5frcW}+ zPaR|k?BbpVc=VbvDsR@|oaGucNa(ViF^2a1mEg2rTfuLP9Alr#0K%|N-v2Xh2rc+$L$UZ2T( zZ(gvQ&>cZ+=7wf|2B9Ud6kHJa$k>13*26oLvHTA;FY2%u9EYPG>wN*xN431*duVzm z`-}aRi`N19KgCg}Ex~0@ zxL55fm3I{_@0%&H9X3dPy$uSuv_JZbtD*SXX(RIi!?{Vk zVlJ?6jlyYfyS!Wi%bYEO%vZo`{q*)Tv#XJAYVY$1l0;J|8r(n2X60?Do30?uKP$YF z>`Vf^bR;_V;>IFj@e^2|U3N{B^|Ip*GcLQ4{o)J?Bzd)r&Ov-YT0Ne1oBjFp z|Ma9!F0C`4`&C+|f8SIVqj0Wz7EYZz<0w)HKG*Yb{Jv1!yQeI#leJ-s*El!+>X#Xp zh|_rg3zf;_tVoH|hjek!p*)L^?zRojp88EyZ|1M~U$ax&2JGBUSv*2bZg-zjjR1ODusiZ-3$8(2k9T0=keA?0=GX}f1ovNwjlZN)4j=>&^Lt{ou-CX)VRVF^v zjfsFQU!@&t;uuLIzb2k{wsA`#O8zg;&3caWQsk-NfBx(jeBU6tRe|}n$gGSohl7CR z(+&1G|EfQ@KVE~T>Gv=%g>GZjVe9(~H8CB&n^Vl5Kv}bUuVNN*=m5%yNl_nvi~^&l z;}~v|*OrxfX%6pth&+ zU%{@q7v61`d)VBBAGQuF2P(l=Sa_QBO?{4gsn@TyEC~jpChl5$ir|zWiWp``Vfv;FHF;>;H1~|NVo7 z;nT}8#d%4eYf#baNuI2Kvo?M)oBob>OkuIBEpFWSnW$Y`wf3!BCQ5!A9q!MT`Wh^D zR#Ei8u^E`@lld_nXliq?FlgWJx4H7G$vg4=GnAZVrS+hz@;c?~luOLf~>1kIN7R|U2of>dOq%R)(;6n8Eo z&sISx_HtVy>1P0 z%~xH|F8P_qeW9l44&DzF`N+NPLBr&*dvB`vi|g1Y_i`rKy+u5YTOV@o?#mAQC6eNZ5yxS?6G-1^oS^!m%MK zd}g>3`Q1DfqnM1Cgq%DIIm}NhwzsI~%$GMFCHYs4Gt$QxbxLb5#*HTwRD~dTHa`%| zbZ3WjFaLkv{eL3?eDz-lbV{0edY|&Y!%kQExWt6rjXRCwPw5pni)SoIivEH%yrVJb zrmMiJPz9##;j{O%$iqpK*a++vvkQvAP(6JGK3v!`@`!j^JzV!h`qe~42y-B|5mz^u z3p!@xG#gGlPptr}+&$z$Ccg-HS-v6*Ae3=qM+tR1o`?e%EX3%LPmP?{S$tKG-p{_PeGwde~~^pt^Yl4XQax4 zGMy&9M?1w5@1P!3|B40)y5;}h9{BRV2Tmw{vAesk@iE8Dz#&;2kbRFSc^plvIV$`a|&e%>xwf>p~XrYSr8)9^l&*5t~3vV9Kkh7u6yS0@?qM9qft?_|f z#y|MI{2J}eqo#bg4aMl#By1QFYaBY2Gy~A4k4*MV3dASw)uBC?eLD$iR8?!=$t`8tm=->Z%Kt-_)84eAEmK}l6wBTawuQoV zHr7n!*9B$pQwC2%w+`RMY^1Hn=f1johdp>jW5cP!>LNrZq!p86HS$==wM66nSoTY^ zB*oQ{FE~N}O;D0}&aZ5nSzQruzp=W=*J^B>)fP~bCG+Xh(A15Ma{s69R=Bgn%q5r4 z&U}Z^Ab)qzPz6dHyf}MGvzx(=f(<*}qAHz8JqhhfvvEd3QFo z?Yo24|L~eKmm*~m&uP)}%IG@ZCoK)JA#EMq(qyP6H(~qfj>Kew_~g@Ec70yL)1~Ar zUU5hoyVCN5kR{fgr8rbmliymp=#+V$;_=*@X_HMZ^6;G8YP_%QLwBn9)N zED5r*vXQOAI4ftDQSlQjTEavz7X!Vw@dBNH5Ic!sf;33sj(RCCM;@Qgcy{w}6#sPH zdz5jNJy(m9U=neo@m<@PC{Z09gWT)h{p4`9l9w?+ppsA)u!D5j`OaIvF2y zwxM3M;^q0U#~5k7U(QxE!VAH-aAFw7r|D`}2|9;@E&4lWFfd_Qm5C zO|R1L$80H!D>luPMk@?_ThHiby8m_;wImL(=ala8u2sbQ&-%lR>=Nke-)sw{i|YRN zf>;UraeWtJhBmF;H|v%?JgOP6oqACBaH^G^%v#0&cSbp$8IoX{xSQU-BUQTS+qtkC zRUYXx;+lB6_E-U_2oGyhzq9^ytZT1oa@O;(-Xqkfr(Rw)VXe0LkdPgszMlC<>soRD zsV`oIwx@vXO;P!p;XQ7Tdp(9r-TS$x(EnvrPRVz&`9qgt=e!zP9VfKUFhz+ke)BQ?2f zW$$JAFA+ESc_KIw=du4-OzF*YLSNMPy?I~KR<3z=a!^)*bfdra?*|muEp!*FH%YCF z!jHnlDDD}!DAc57WM(6a1jKhKqIe~)QvtT8FD9k^r`<E{PC)PpfKzn)ZwYOr3%x;M%xOZyHVyyB*@u0rXPzXluXy%j=0IYKS}YlRSRBK zSH*ESKOQQn@1Kmi_+u^$G55c-0M#+q`quO2IU+sd&iJ_dP@%kQ|uf|KOXq)IjGIk*shbsR7PO7LV^moY_a$eYCF5wZwPN*g=OI$^qygF>R^={8$l+ii z6y@Z~xUPhhXM)~vZo~`o7MEaU@~fWFCKB3}er{oF_PaK#Y`wDI8e%nYY*MOG^Q$I$ zzxv(lk*x1FPf~GbmeHQ3UzT6J`&Z+s%!FnCXrPP)tk4BuCEh;4j1EbJMOMtRbd(usHZZa4^jsK!@<4&-%TjT6_2@$ID^>}51Pi^{vsX;xM1FtA@vgQ_5Yi(v z9ROcBN_TOa?Qn3+Qvqij4y*qn9#$KKAh6t=gp6$3%1S&{5C>n)itzd{|1OzeT7}^~ zXKJ$>?)GF-DP?P4^Sk!5e|2R`A3rUxR6<;}K&{vBCRdM?fzVszF zR{)-i}ME8PmwL>=y^M2)W$ zjW!1prk+xK&Har=vm|fOR^?&p>HZ%dZSkI|^Y9aZmZ_>ZGQSl$r<@xXB5;SNtR< z-hVcou4ROObBQZ&Zx_Yty^dZ7-2?q_EEtmtLUj24$RwIX0J@_bxt5+T*iS#<9Mnlo zFqpnNQI}!uJiWkWT*YwMQn5MPDEpc4yN%W8DQKNZU6EaRFCyqt#(k?rZtk&}t$Cyu zB$?9)x`6alB}Hm#%uo+goNZ*s7!lfjSWn`LmpYfSZw)Gy{V+t+ z3&2YYcA;jnqT}}S=dOF4vSEz4n+~62KfrPg-y^6(oy2&Y%}(63A*8jxBZl|5j2GoA zdI4rvhHOJHQ-9lONs1qpegtPB_g2M%yuWX~_vqHkov9$2I@3lho`ic~{q9?RiLF6@OTHo5F9Nd@HVS8exq5v&gi zB*&d&M+2p7q3$h$Jbv&*Xw-3LK$Akt@;CI{rJR$zv=_};;=3{IBHvftO)Ep5=ENW& zBRb8u2%in$w@n??I=|$;wyGR2O*)jYw${I`y+ydQF0jRYn@x31I=h1R{pLz|;*nu> z-qxPNDbkJdIf>y{*TLLjDc=KureAy-ZRtS(*D&uPssh5p4)W!EIAI22g_ZaC#0yk- zd3=T!5fom}TL%U60wS(UKAgIjQBl&cygTj2=Pw&v=`ji&L>wdnjvYiV!757gS{1GQ zX^W-<3M?#F@WsI_DQt31gwHzGca=}ekZyKUZBjw&-UWR4G4Tjh@M7e=S(@qbg8j2@ z71JWd0nn%!FJ5%nuJAG1!kV+4Q?tNd;=>9YTsV^*6}-}8>fZEy_}#O|Uugx*7zh2b zaHz$hj}d+bg5l2YpN5)Hlxm98nJT*s0l=RJ{#K?_{LeVr)lUOvSAhB01GmosH=8-5 zq_30bTE9%r$dz-}3|!E;NlJh1WPEE6tOD(*l^q!!kV_Rs!lt5>?vmRLLGM~b?Odk6>OHG`ZPY4Mj$P)ezH_0@=*LL=j=EuYV9Teux`PGx^PS(Z8} zu!-aw?01XIM61>-mqPfjX5iAz=pz6Z2ZNQWNCGW?z~4{SC5UM+>BDfCL_5x{2D&ez z7xV-|xpCf(^z!2O7K6^XBqI?_D$BP4(xz4r;lIV)z^&2Ui|FkuLCL!YwE8L2i?cQ!1LcM7NQj=pZ}sGRH}W3#?VA8~N3xArX?0 z*mqf%Iao=~9Y3CS_q!yma*z`oc)9*9?38MBl0#Kl>|;!|$IqPZdZ;^khFil|$<%ZK zuJ)w3aiP(fy}fD*F*vkO+}GN_tK)bxHqV)au3N-Pu0Gp;fAxi=xN5`v^AZA;b(c#F zO7cK8jz}8{-I+Zo_LhV2%hyYwV5AOxsdt5+dw82pcGVC?6p4pwI$k7Jc@+_IL}%-K z?CJYAC{=tN#yc^T1Cvop*5SBkeQ~){HsfUHL8KEw!Dib+AICCDzFB$rTNT=>Z(TDY z7gZ+M-xCMxKLZIMrp%(oiHa0ji&m^2^w8y{$Gx@25}A{I(sdS{{!YIblFrp6KQ1Hf zFzHB6j7Y#Pv7rIQSVX;{0zB(KYvVG@UR0aw_B;h*?rCUsI%u>@6tX>;Ii0$QfS-Op z{lzPL98qJOyRiY+{uBPdZai3y@ zt+Y?qpEDS<>sH!fbuk-Q0m>=?=untktiARtsgb}E$1Ftj=TaL zAN5<0T^a5;*bxOOc^K0L0C~;6We&Um$zM}4YP6!E-Ur_`%^;s$Q(}Nou82IDl>_je z)y{*9wSzzpYLE)llK1*La1k!)yR2ok{h1OB{gY$$k)ydX&hF;H3$@_(1YW$+$TiZK zHg#$y+9rYVfWx8ywNaHPKd{1f;8bC6EH{&F5^N#1GfCgu5U^71o0vnRA70F7nP1mN zo8dB|E=#&b$0=G>MX%RyYnkqJ?XMeI2*sL)O|RjjZ1!_ERSfiXCWY1|o7cCQF0X4{ zITnaf36$c?u&-#Ge++VdEcedg)uD`6byIZU6@sRGqn*fV)MCN4$Fq zM88wuk@?7(YM&En2g2_^d5OqV&BasMG{(8E2A;R45;&s6(%TOKP;YGd9Tll64Mv8oU;p$lIjqIti#dit z=Uw*xs;_!qt5=@Lj(K%J^eft<{UdK|#IfS_sFqNTh>p0XbeFpbs+C=cMq45q9|oNF z1Nf@5>JKy%x#F|Ba(Xme?H!}{&Esf*ELmSTsWz~KV#Dqi9mI4FFk%jbwKAJYzBqXn z>dgcHX^(WLF~P(ti?R4aqwDpTA~A?mQzXm2B^&dpQT>+Vp>x5tc%_!Mi&AZf2#eG~ z1tph*i$R|yq{6&y?~6@ndN1wQ$j;!~K3|rJh!DhDdps7!Bxs%Y01~h#hYC`eJqMB2Ge0qvMR%V1gCrk;xl%C#27zqx&h@y3>#m?~G0liu+mO z4>`?xx4b_r- zBVhg?@=9=b{Ba21_6(AaB7=>`4O&JLa5qe7P(VHRsR1k~(y}kvW*i{&=vYN3SFe}E z>baLL$CvRLL0iRJeW221*k%MjJOrH#77Wlqosv+D zl+Fw_ZQ4Bg10U$&85-Xgvkp;Y@Nz8u^0lql5Pw5{oy%vw$NF_>5T5BWZtOxmQ_YXw z%>9STxW>6b_YGW0_dAI+O7CE%b2s8C0QR!-;kpy1D$NExUq3W%qvGA8#_n1gaoKl` za7(q(y{vIG4NsmEMeXFku}IL*p-}yXnV#PKDS5zMAntB6?@4KhmmN@Ozljro4RC5u zy+ph3ae{W5kzi zTxbv-kPphVTcUniKG*}Ngl{Sq^!qRK`dtN!XT*Z%1%bu(@PI22pX%Vtc0f7F#vO&a z9CeRNya1J(8C&}p@A}*EkcMQbWe4fDAXXrFOm9Bx0&F?-)+Bg7aO{A5R;}wYTdUJW z6`-!}nd_QqgG!9^s{oyswe5?AqmxNs<@lY5o9O1nZM-)uLPz%v@1)?1 z!ghS@ah|j2UmXj=5P!Wm2GmoC@rqK3(DtLsJ@iO(apcXiisW7TxrN3rZS-X(aajsm zAN;G{H~FHG_rr894$;jFUq`(~VSgqGMPaa8uN5zY7s$ydWXa8NYLPq4S@*9RjEg0U z1Qj?m(1^{&>AjV#QzY|dkRm1LF|!3}1B*_@P*x_ry-XqK=1v`?i&PZ%s&Qe-bg#=1 z_+!B?7)ojs*h@zj>)Fy|DQl*RQP1Df+PJtL-SQM&VTQ29(Y_1R)Z5q|P!_pHbYsOs z6&|q{j4&8>_`A$PDMBUYi;xG^Jyd z2_pU)%E|>fJ!~XS%g^kU1ohM{$D`DIc*rpM1pj+%6#Xeus~V)0F@1K{X#c%|Ra&;C zKJp^L4oRf*3fekjUKz1b9O1|oL*bOJJtaflMy^J=`B-v%8#}^O?saBy!{f)@;s=4g z@DZKlCJ*Xs86Hi@m3`6(Ur-LORJzD~y;CNmNVA@D#oe}HB~f7o_yTa(_G$9I`D4db+E8ySmsY0bjSr zl0tQ|DyYT2EZ~}m<)<_<3E>Yy611*eiML|>T?^>XZ))%x*P5Rtw0xlB5>RJBg|SWvZ5Rc~JgrP*yJvVZGh7FGx4i8< zv$fWjAa8!XmDdjuW!LmBGQJ~F9+um%`L$#XOlF24zGj8Wdc@~ST77Iqp66Ug*Hm-& zdxv99lw_bwBNFDpRy)In1)$-)5Y!FLNdr?-*fBPMC+c`uzO&3`t0)M^RILYxfFe`F9Im87`<3t3UE(mX7Pc~;M`-=_N7178?3ufH{1jK z9-$)|J!~O%$!O)OGzk=&T%`Usw!GI^rv4KE8uDvP8zp+JcuT;788voXoKyN{ z&hgNG*iC?xVTOfW!|PtRYhIV16gO=bNc#K{2nwQ?zP!;xsT({&3(NLk>WZfAt&d=&GDmG%%iQ*RP#bZR#8uJwZ2 z@lJ}a;O4f~T$j{FT~!;`-4{87?i@4n-*)&Zp2=ns7C03U4*auN%R&a{n7+*}+r2#P zZc>H2f(d-~k8B->oiUQcXlN9Fz1JB$ZJJ=u@{^>K2naJv|xH}bf@{IGp?xqSRcJ*zG?=-Ngia2AV ztH-x}Z%?CxzVfpD>SsL%<~P#(Y?EBEI;r+PEZ&1sRV)WibS07|9}skKH@&fFR)yN0 z;oet7liefD(Q2K!Mg4kJCL)uzr3wPTmkj%R!_-hXaM0M`x~870IADOgXVaoLPwMbkV*$viEXe(vL(3Bh5}HI`Wl zSRCmuGl>p}eTei$Y%JUo^5))(b@g&w35&j!CQ(q*?G2m9aSRL#5kV$G&*d>9?u3o^C*i#%_szPlQ*Qq|(O2;5Mm zm^v)}L0IhJWS+0(LF8m-m`t4?Yxv%id&{}t9C^CnVZ ztpEIG#X132itS38Dk)$)C#rm|D3EepWO5wRF?%u2^=Nv&{z}BHGy*6-k7w=THk2Wt z2O(4ufPvD4L=UrvbHwNHoApcT`r1z^ht18IlS|$0XAg+Cnhx?(GocNdw&^uje+|b{ z?;7Z{*{?HrMNXRMAyB6zs)NhV4h(nu&X?@>z}pelU(CxCM~8jTp52&-9pJpuX+xg@ zx|3-GN)5Dhy=|el1#nAmirmsO;3tq!n?X)V^>)`e)xxu)!;NWU!@j51)b*)O!=nLhd@wWH^VQY7FA zDxGPIQrkyE4%YV{8=&6j+Nhsau&6MoPVL#C~?+V5!-;0MIcY^;ZA@;&o+lU-mNB54R2{+$UbI3+X`zRdrC(7woQ+*GU2#!h4Jv z={(}TA1`83?&_GgKnln9`xuX^=jwZpbv|+gjg>*wvRybpnABCmQHCw6dVqkGNO$n9 z%)eUJ$skbkqk?)W=HxxsR{(@`8`h+MZR5k+ zUDq4t)nG8rJjvK#rG(kp7)4M&%-=k{hH1{5^;%z^o|N7z@VL_%3eYA4-N|2+B{Mp> zhkAoDwc^J%4N0>#uD+&!kNcG!b5jax{)<-58s8AKi#E|WmeJZDr3x$hD6^jp4baK{ zolb43LJ{!pgh%@wXC@b2d2dqhFC@k0@2zC1ZRbU(R(%n+1#6__j{2ko3w;8d6~AlH zaRUd5jfS6$Tg;4$Cb}X!ZlBoZUJnsnm4eR%Y{t$BwT%Oh!=2$JDnl35^uR!+1@%ah zaI?Q25@0Qw?rW6#_UU1duj5v`<_46k&_V+=1L<3IU z2Tcb63f7#kdb`&=5#U)-1V&hKOVzAb*Hc;tiUAKQA9EpUvXb5*DR#L@M>lDxZmx))sFU7r3_O7F*(rDGuF48`JN&h%yCs`p_AUF?Y~EvdF351T;Gc04 zLx1k4$lS8<8S>nlkZgpalsXUoGj{+{_l3=|iWJdH`St8`g1FmOQ#5pnrOYg8j(Arp z$+|LnZi)DurYU_2452qG^&#^%`wTv@Soh*gl;9o{elWGc)NCp~+0aB@kuf^yU(@tw z(^Ey<;nBR|>d-NPkQABo24gNzE@HwDVew5KQqp*zT6r?OgvR1WtdU^RNt<0+xG42m z*?-M{KbV|eSO2(H@PhUqS1{EOR*Go;65iE}0udkA&n{J_11a$gVJqzIf$TDI_S-|( zT`krNp~jA=G38!$5lNXb#V%{+N+HB!=AW{NX9t#Vx8J+`mVSl}@W&NeBlzrcHIG8< zdmtJtHr@}>iSomeU3N3rd5DzI*YUG0ieUBejn;D)RTQRNTdLl7b}K5uyTKt)-x=?Z z(Ohh@6M{cF_6OKhi3)W!l>r_4HlxD*=Ibl#dY{8TjqnZJ>ha(Cns`%?dJAQr`{&#U zM8?tI=sa#QzrUvC3}VE*rDiYX59LYp?*}@}v)=X((*_QVl=Y60w4^>7{oYSRifJzU zJuCfwzqZfX&rAQ^$XD2sZ^bt|+l&E`2*J*|i3$LkE!-Kf6e_U{P|?1%)5XlD<6_ip z$g<2FRK;>Ux_w6`$_)p|9~&AHIRvLmkeZbr?h zxq>=^z8!Ia=#QRO{IQn*5Pb@9`zu%HN$8_UZv{0T1#k zGFlMwKaB*rYEFpy?Quk<=8UaZ z4i8fCEGhjKgPd=3DCwaA&YsGGGSMT7xK~!=6z%;>Cv|$6=s}F4NK8no{PFTth;jXo zWr$Wsm|de8=gh8EZ{MN!rPm#ay^im4Va6ZmTe!1xFu#;OsJj38=huhMU3RkD(&Il0 zwW1V^bQ%<*X6ahvwnR*_8TG6)5cseUUMknC^e?OCL2aFOul(4|hk1@+m@!xSx#|wP*(edh z5M%J$3^d<%pWvGWixBNpMSK=lMl60M_`~XKq!cjrt_W`2swL)WMpq9DZ5ZdtYFS#k z*aQg#SUe@M1>`5jGz2Wkl@PsDq3LEhuQrqSy-8up@Ued*Xv$N|!9mlYBrp>)+ zvD#}rFL`5uS$e`Q!6I;4=N##O`dTB5*bQ$?B@DB>;2-gGAMIa}%JGj2Ile2(6TN;;h+A*K%cxLX*^LD< zfj@lcrV&|ixh#z$Rh6xp$&UEUy9T6DUYyzYXtQ5@g899GDm_}sl_AyC zgw&|lb>(~nNo)MWE_lMU0Qe#GS)@wm+^!cmIAGo9yWUOCma8tI1m)#d>ANQb`>-SMZvaSrKZCME?)*5dnj&;e zw#@2dU_UvieSb7_xgPdacCLKD3+~Y=c+4v{E!Ai#66O3tMmsUgH)AYGS!A4%SMUeG!Ja|7+)GH?Xm~ zS~k~ib^)-^8VJVwBOg`LP1fMVc$R#(=9V{|{7+~q7PsZM^y)Em77FXIqQXLHDP(3_ z_}9pMn;#TaLlxrDQ~lXEbmM&g&5rkOnnZ!pJD`0Oic0Geh;4RfL-jHrrG}Xi_egVLaM( z)VO*DmG8SEBzf#;`~{a|wh#W)Mp6H$-Vni9XTheh1aXXxxG8z{mEa3YSpE`IS4C+UhyfNDDZ8Ex+ zd83uDvoZi8+2brKhk!Et{e`+Ain%-5Hlh@)xmd(_zAb?nPYKRBO{Y$abw+|U<RN^(uNkQkqSjs*QcSp-W6i z%gx&#nxs;n1#f>Fe6oGeW7Fsp&!!0-RKUEAy}Ru9x4hoXE&x1)l2)51AtN*i2lie( zJBG4J(EcURN@pVr%dkJj5#E^{YBn;*EnD%(ptzzmu}tKExG-0!NEp}{Nh^1M)s9C* zTwd>8evloSOep|80X`I;>(hKEIUu8RfJnvjg9o)|4RGgxr+`Ij82b!h9P4Wt3btGi z@6idf)faC{?BM1WF^%iWbvN-#9QA?hHe-Q{znnL@@f2^Q03zP$l_A379Z%E z##6|A`F)Lu#iWjh=3BM#9oNe_58{dvJP_(Ld%*XR|r;tpwD`6h7%MAe^ zrKb0{(b4rr%Go5TxZzR3;{BRzI<*M-qc81=Lt_le69S)%j?xONrJh>v^d|aaz^McL z22R;xMYXK<+fUQ%$`!jSik)9=>(?8A3&U<>BPd9yn&rrui-^MoUIRqx0(*7C@A-2V zGZ#tVzAZR_nF?G^+Ye3F3m{Br*Nay$L`mlpE~*Dvh>q>wfQ|j738pnYXhOdq$ntd< z=wVs2CM#9z5h4{9>8`qwxqava<}N6_A-a~`Kh)rHRmTU<;pyWfX^is3`EGjOgB%U? z>Zt5T(v`DYSl`?zOTV+{^GMMRtcoS>FDo2sweC|yl3)CysXBXS&N6%bjQ26(#w4j) z8GQcA%k1gzK0gig2W_1>E7MaBxOS-Zh&i3;t$KY(tw_~}eW@N7q6nP;i2y?~w2`Eh zpJ5L>TlD*;AuR%Wk!;7yr243yhLb`~Mnh{bkXJX{1n+D1ub)vRZrwpFnzrN+oy9S! z3VDOMV%JbdJBw7RB2&-iC#VEe52hMR+oIT*O{63JGxMfATArxpzsZ7yh>OQwl|W0> zkzeKg5x-~zfbre_GqqSF5Z<*~bLq>`c8?^HCr9AZAI(RR0oLFR}{#jPr!QuvLgwkzy+D}$&p(T6 z%1?PKJbCAa@65SyO&o3Xz$>T$aYQ2$kJG^&F#p;Y;*lDO`!#W{sTO0+rvQnz>VDsE(qh_+v zA9EZxy<}UO8p!Rpw35TSU)=k$eX8JY4263D7zAwq^Gha;odkDuy1(9u0+E6;K*mn( z&Tl4%uJy|u$(y^}V(A#EFihp2D8(ypBdyRp-o*;_ye&!RFNKG3*epz6#xz4$m6xVS zlDy1Hl1G)r`ZOQol4q8r!&BGgLH2B;Z-fzcu{$u!k(w1#c(IM{@Qs@&_77ZZtD^Ry zZ`s};GW*y^GbgmI63j!27c^bKAI=8DI}YS~LL^J=ORSC>%+D);+-ox63HQMU6N>@5Cjo4; zV~jpt!eu6gsV}%(&3As4^0DKMC_dhQm+ja+=s0=kBRfJ!S%v%m4Z)7h9m&w>KzvW0FoI)dZ_X#|p3x#E{n9>U3P|*LC3?kZZ!0j`$RXu-=xHQ* zkugHX&SBEdJ@x4>U|5U!H+`x!TeT3yA}ZHwMJhtuQmj~NDc|TQe=}bg%9b!!DpjJPxm4v-DV-oBT7dV?7@8peTERq8@{NC^QS>knV3{c^eg&a zEKm1`^lNVVAh4d2Dc$}P68&;A+B%r7iy+#*(yV9>|yxSGDyd(;BsdpIoa!{#lWkBz()}t{RkFG3Jp%Dc9(zh9Tt`!(IG%9K(eiwmIpvH_ zq8h<8Lyk2o&W5xtmWom+V>AueTapETd(Ho5bnvVr;|d9VKc5z0pt=~d5w>`8{4N6o|g-GSsU^%PU=6m{KV8>f({+Yxx=U{ z8MDV;iD~JR@5ELUnBR5Y<#3qJNn-U`wD5#gNFH|SXZPPZdcuY36CK}>yu476cU|9K zl!}Td2M++z^u8`BCmM?ug4I);KLnVrgD~`^PTeTmEAI$J+-6Xbrohkp1V#GTs zY@!I*^Y!C~%p&`;{$rf7q+jzGh+;-K^x)k_k%)j>W8E{pY!?q-B>&3Ggt-jUAI6Idy^O)YIl(}y5x8;vR090z?&$aK@7(^{f5k+y%n~vZ=4NE!gdY9Chs7`s#6IPv$f^%N1N*wGIZzDkG}_)+W7okR(aJ4 zc(*ylABG!zrU~E--cx=V;$U8^GwDgL5{@ES$m|+loE1Ndfnzn|f29pby*w)1_3&C? z!$)EnzrqqEhYYHsJbm&>g_^0tQ88Bbs!GQx3JrBC-9FWs7%)y)Ov^CBNl7{#B+vDm%RZ{;W7_ zBT-8Z{kA-91v~sC3n{)44gbNSgMoRxe13^&FSF zSEzngHi^m^N$At&gvR-?|ETMdc@~pvDE&a>d2o@I)n0W5 z?HkR5k1fd;_J@B8pjd~Iq{SL+K2gLM+45KWlhLZb)>VLtDc^0TuB+!8ep)_R^u4<= zt_TV`%#SOuxhVG|UViEOo?un3K`Jn6Z)>83!02u~JH)T4{>)+37uDtO-tqR}|Do%@ zqnccs@KJbgMS(3vMCkz$q)Cwup{YpkMT%4j9RgBA|O3L zNGK{G5Qx-73B?oK?)RME_nq_Cv&hO~t;}=J%r)1{TsOXGK|^NAX0e5Lt5j90#Q4xx z)T*Nw)YcR+~7CMl!~3 z3;%_z%{X`D(z7g3Zi}W%k+dKYTpXfaXctM|?0M%B-Ti~y|7SFdrE7Jn3`SEn?83>nU*le3CJa&~Kisy*`ycg*fW+09(x0`- zfXPo$>US5q@8-^wmuqH`a7ObT%JIzPkGt~g1vBWIYzcC^W^60l8O1)UId)3b>6e6C zW9sf1E0>4(A|8s`{=0AZZsgkM!*S2&S}?7Jy*JHjHEVy`TfZN^*B-VSA>UGMgq5ZF zCb**;mHU^hC|h+q_LoTF3AQR-+ct?M47_R6 zn{Yw4e=@E&5wDRr3>>-e2~Bg%=%@B7UKzuQ9`>6qhAYxSGWy722pG7uBSn4ljw(ye zXp`?LAu)22rgt4_-ON`~nLY_0?iMpcL-*k((7L_QLDnMG@VONA?j_LUFt67uWW4{D z&2c%MK;yCBBsT72M16*B%CSYIA$Rp|a>5O4VvnUJxXwSjfunKuSAY{oBM_}_Y5o0T z-9}}n=YM;bZ;CE{E+5Tyq;Qui{@Tg&F#~BhjM?)f_)%T?)C z!(DOQhdgZJ(c8yDV}UYBKwvs(nlr8Glax!0i6kmd3$(du;?N~s!k|8A2Ry3O@6&T+ zsARxr&hg<#5i9jZ2Ca4CsI+XHj*FOV6lTDnrIi=DQjS|oUjkJcEw{wfSZk}X<1Ki> z*BTwY^QMajD~|Hda@}V}sGvS|i_Y-Y7y?1+0l~P4Uq|y@KTMAHEhs+AHnY+Du{}R) zM`8hhoq-5Sg9D!{pA5WcmyD-~55DYlJl^iRk}r{JjWp)MXE;fBFZDY(dVjQebo5nd zDkNc|wE*Q(^ZtL+jpxn?7e(%_No(x(I!x{yzIWVrv&v&vrF?0|l;d^icy0uF^WC;` z_%BMKPWRkFM`x^l{NRn&)M1udjJJ)y!CJ#FM&D#(n6t8MQ|A-ov|MU5t<`~bL`-UP z5d$}?V*J-LIZe2TsbEpg%5#@8ky_&TRKNJ1r_LSllAcZ|QnEZ^tMiLa-dwIF;uV?1nC?X5L;Bm1U>5ZPkE=K=Hu zumYSw3O2spFUW2EZ}PwM`R(1$GlhHkOM&+C zRb85|zhM?0I7$3TZky_7sOlcS2cjzJwq3~|OlDtsvL@zu#*Bs&Q5k|cdUr2@;CcRM=9bWa#oafsiB~W-SJu#2G>JFfelL36X8S{Ty;d)kf&# zNy;97>?L+lU|99r<#2X%6zX;V|FZZ0GiaPnYqFg-6fOu}7oo}0{ERqTDY-hVxj6M5Y_t z%`Q3)%V6zX%t?tgTbNtw=?^X~fQSZ$9eUu$bsPbfv*I-)3U#eVsr{G0rJYMlkuQG~ zruhYMT|h9l+Y)(>Da6tv^M?+$%Rf&S2im^_W*`bYn*C@bo*PQmc%Cg|2r!D2@ZcAa;F|3 zBz|3-CQIitS!K&+K`$joDUn{D6#eQdcgd?)B9lyQotAlqQwCG3SlfnfE!Y(Zr8dT$ zlRQ|mb(uMerIo%A1w#&gLnRp-?Ed@9@8nu4%MC8aRW0>N?ZO)x!#B)*Wm6<%pl{-} zB1jUiz%Bsw>3D$KG|UHpV_!WRbcfe1Uw|r~kREo{2M#!NUL4~C2Ijd7uql5JNQnsU zP@s~obTvMWZ52*G->&7d!+5E4(PXl8GI)Ow`T?s`ef$a1QR`S!KoKRheJ>G)4=3+#Q3Q-9bBXEPJ{57Q=yk@_A6XV4Ohp2 zvF?7o((sA^gNlaRMmc&$FZD8)#H6OqJ1kEbjIUlIHaFZ;v>Gx2Sa!(}24B>6`h%kH z3aV4|K%dm7UvYq#&GH5)VS)Rz9#tbsQ_Aj3cB52#5C!BLq%rFP_ZCZL-K`t|88)b9 z2LeuHL*z&55AzBRge(6oU*X;NuEDtX5h>XC+ig1)qp*fwhuqq~7ibsuUnwS^98X5M z>}NL4Vb-HgJfwI|H`$Zzj}Sc*#Xk%7cz-pe1Pg$`JuPs_dkf6(BU;!uuPu>6SW2hZ zA;C8`>J89Bb}07PQb`N=`^&s)h-|zG$cP}GZ$=e~x@+_w=lln6{P+0$OxrpCp!#%> z0e|~Rc3jc%%b<>n`9;6xw<05U9`fr=E1QkROMsgqH=WJJEnIR%EN1$d)yIYQa3dwC zBDYdWa`8%~V}jE%tWA+m0eRk1p3YF zt7mDWWmv^pCL>An_#(I^544^*r_hq>GAX`bU=FJ@$Q0(n8`nf_(teN7uXG7mI{Wyr zdmODErD^>mRBYKK>}$FXyHj9*@F)~wnEDM#Zs%rUR)^skySLqN-@tB%Gc{ZUmG?ggfU=RY(U`Q{;oTmB}QLa43_ z%_>LTJZU;f#Nm_4aJ2*9n0lbsKAM`0PjCjLaikWkTB3XKGby_At_oy=G12Jpil!X8 z)DLeSxl)WdhO1Q*ZML>@Be!g_$xM?;JH8s;Q^%isB{|f#>kfaQjo`1pl%RfVgppRA z6xx4={c4MN@HW8Z7l0L>>cfi187!PAIeKMHqO*Jr7ME6WY%7v8z`@RU)FN+%8S*F~@q0fm!_8VH-B>Ic?+hEe{$H7LcahNyiTE*#63jFYl5@e*dTM`x^L{O#5o| zq)ImB-hYtm{|v7ARi}h@eE5pboR7|vN4`A3_5dcz#Cs!G`80P2aaKqEH+s@(?m{E4 zg+|K=!NZVcoOkmihFk_Wk;sMGw>Y8Xn27xf*07EwKH_YO7JgbC$qFr1A6!!UGUZm& z6SyJ4=gLN`9$NC5S0Vtl-rOs!4jFe+w*U)V=M6bBt<%Y4YXoHQ87!yH(vnQsq$H!h zHy{4+_}NhKc8qiBqb98KQ@b3pc{0*hmOLCnEQNR?dLI|3vH!ysNEIO3TYH4sl5ab# zaPG)2>gwAGnpW2bapSHU6wQ2P8J2A@YkltDq9_fdN(qg1jjn8`;&l`s6EBn=&i&ey z_)blwf9kyd^IP_z^HhrwTC3Lx5=xX_^ z+DhIq!YtdY@nw9AT6G}qlT5H#k9SYfgQI&(zG(kh?a>O%A6*0Q20n&a2 zE|uJqu)|}f!;vjau+FHMjM1A>N1wRm^6Rm1Eyg?;w5;)@iaM4PZ>ajtIC2?c!E^-# z0RY|!C*w<*E02DUb^X7%K)&+|x~yi#~IG4fn>q_M$`ywlccT7G)C=-p8O3b0 zla!R$ZN>{;-JyVli>jr|!s-Ug$aQ$jzm$ZOY3<6W}~2%P|>zF#0C4sBTKr;WbWFfKk61YIZ@ zt)^9UwBiG?{aH@_Uvcs0r2jvU`0aN9ZtB%-gH^&;aDW+5_TlZ2L0k{a`n_o-J{M_ZSDiZ z7Hea*Jsg&qG%Y(7^@6~MHx~lz-ZRd_;nX1{^Wa@`Vh|uKxf)zSWtyEfQfma50wI_w z(HODxno>!rDQdUGE_+l|IK~XW=>OCD|36*&^e+it3=cJ;J-PK*PFFxw{>p-@P2#mZTH&Ae z=12KAoBghR3a=mp{hY7E(;jBwwUc4t#Ab(Vx+EK|D3_$h6Z0j%_(w_fyGlGoy{3yL zxRUfyxs9Zl0-zhxi-C~Z+5jy>O`i8Y5|MS>pR%ffUB>etVjC3tift5=gEdtSTf0%? zGvpFpZjyA3jOTKx|MYre7rcJM2cRbNxCDxbPJt{r_dL`qa=LKH$T4E~lj9-&GM-Q4 z(edW32BrknnfMa>p5c#bGataVn^`Se+)@=6v6Xa@t15PnK$*UBVhsPB^_zV~`~3EB z3{1oE@YoT%=5~C#GkscC`_ORZPIi4aZ*ijIiJ*G}0u`sFgQUF_1eB-IObS9BWrAa$ zsTY`g)R^!+V&*u!iD?xnn(aE5mPo-1L6&M&th{*RK$hxvIsK8arn;ekF^^mh0{4>E z{7XIsf{edmb;yKgBTSBPZE+VokR)&&)uiPl0`?V+ViVLFLSCO7KJgLI;ydtU*1$G? zt~9!lyi-wC^vL1^)W#N3H0$^I)iBqW57_5d3rv1)GS^V03_)l9PP3qDQ_UZCf4Gre z@<~se7><^TO5LepVy%*Lg1xnRv2r06>nNk) zUK7TXtP_^#Ezqy6ZgG505T~6RS%FFn1nG|t7-X&&c_CyKntbD!Y!TThWGd;Rh$Mws z9_p^BP;Y_WQ&?CsQ*TU-jjDmgI+`I8J1K_j@O5;0K}t(_H!mi$rC~OIXSjbP2c|SK zJjs*~q(vDJ9u}!5~V@L-MS%)NvHy}fAq0y`cVE2g_<}0acBMlL~3)P z>&^H?aKsL8aI`4y%6}3J)CJpLcE9(7RG!{4Oq%_xDgUxXg;AN%Tp1%iM=n#5o;qQt zs=yLPEb*O>+>GgzLr$e>L9;zCvtM=*DBwU#59oNSn9q&br6AK^c8yRREe`cHmVQQVrJwzv9xaoGXIkA(uq~}Q7J6{(@-#>#j<0T6C+l^aAWf|vnmDG1DH(-U`#(5pX zs9QL^d?18xyo%(i26?>n*FmK}AC+PKxb`1%v75ergNA(NjPyEd`t6WiyG6?M8g-R+ zh7Knt;V__W^y#1M56>g2zTJLcy63#qI1uvv`3wGlz@07IBkpW)jpM(l=Z(r~mizwM zzMiL&?&rjI46O<0eAFtSSw~sV7^1x^U0lv^c17C7Kw&!X)Aa!Fi7CMvNH4=ca{*c9 zwjI=Sz!MLbr;4L|b#VX&BuIM-C(G})F}Lv^zLp#$r?qMXsFEwMYqGCMsG~7LlT>Lv z{0L+vmrHht#8*PmBUSpnSDen&EG>$xz};w-nl7JhxIW`PbVj=|r}yT}snH%5M7%!~ zIP6m*AmkfP+LGrE4U2SJG_tC5Zk|V<=R*TFT*`UpJ6-IdahvFnN*-)v%4BhAoX(@j zy|FcQ>TTJo`i^v)H)wSKNI!^Y7b^lD}Cg1y2Bl};{e|L>;?pN+=%J+!fE{edH z?H&KQYbS1}+sxE&yoov`7mjnR`lvg%Bf!D%QIRTz?lm{$+>dg>1@go)>0c?>M)zycpmO9aQWNom>My{@K_upXuHB zZy=?n423hl*1ssiz8`*!+t(3l@^tD@Kr;HA`;8Bs?dUKn3dnO#%0+8*JitIZ+V^_2 z3XVx_H+iK+E7J8OSiL^3wCGd-BE^I(jga@zhPD+#-tc%;Qh^9^k-*&~Qsmw9{I-F@ z3c?I-Bx-)Z&(-V6dR!9qW^~+>Hk7LS$~RqnbTuV%Ga*oBvS!qb-96S@{sNq$Jww3bVKo^5Kb%a zctnM4r2(+RxaE>KJXpj_x};rH;ywIM#b;r>q0`45>@Pa(Zsy)=xrnucSICq37=|o~Z}f1$kKT~i$jn` zok8kQE2Tnm($j|lZ|dPt!{gm)+wRF11_kAd$hudIqe3+m2H}a3b==HdodLyzua&hC z8=stS_m#kwH{0OY7=Catbup$u!Vp=HFIv5 z07=dsr1Hl{N8%gQY01O$(Qkb~i@`O(|7k?mQ6*ISoTz&z6~9l!l~cy)O7xA^JAct& z;kQfHM@knt=ZW8caGdWi%x-?W~Q?Yk+CsF7g=*)E44RC!pP=amMK~c+b9ZOYI?O>_o@4)a4h9Ro7 z)FEwj_$$aS`$U4?pO+raQq>c%(cfJ18&SUby@5~do;%SoTzxpGC)_Hp>@}tDsFgba z6g4aDp4ZRbzP|4L^@{g|{9tfV`J}s;G!+OS6$!`3Rg{mcI?A2o zRBP%YBDkfL$=|^-f!fDAzUJPUt!VgT)qkr9yU1V2;yh}CunloVDql{)qOws6o0=IC zL#?P=cFG|L3;!Mg2Lu!i5?_C!u{Eo-njfShA$5_OE;l`B4EHhVb%zIH_ZI(@eaOUH z#|3!Frz^j6>pSx4fDQ4B^@8xtGdo_h>Be2FYhz!cD?N;?a{DgHZlu1_jk%Ax(cI8| zTMzT9?)og1YNNJ`kh)&8Ew1%8WC07`)RyIXC5tA`w|${xmKyt6%TDd<6!8r_U2Bub z4@I(;x&?QyB4srkk*;V}$E{fa0l%g$=6DL64x8F_hM1BDlgjhk+jXaOY>~r2kS58x zqMjtlG8&l_zwOwT!nsxa({}PJ=ZAI_8~$0Vq#**t*ChU<*sXF@oD0wMbw?)~pL69= zVZ)UhNR82+{pau0wcp)MxxjPywsxxJKc39ljfSu_H#n9F`h5y~PTO_UXF%taSy(y)?f z$PI0=kc1&;W7|*09Xmu{p%&Kryj(oRt9HszO}yZhmS}gC4O3#KR!_m#rJTTDn>uCK zL)ODGqhuX5He!ZZih5gefebXza0O*$;*c9~ZOS--sjw)kC?wT88|tfLN4QK>^tRg= zR3UV29IKSucYO$Wqx&DrWoIo z`X5gsfA!)oR6W1_^FI`d&EKcHG=C!kMQQGS9_iK5uH;i4Cb-B6H5j7$mvdFeulcJ{ z@GftL^lS-2Q`Z_9YD_X%?zdsSU7MoK?X>K%y==En>BCw?ax7)!|C3Y2w}*`TXQ3Tz zlPxxSSxqKtIbLtvx}ASM!){T}`!Tq;9hz1W_egxYIN8X~6Cq#GO-L$!e1ok?D*=pW zQy-L>5^Cj!B5n&wX=zJ01a5HS))xy#4$23CatrB$Ep{)z^}n!BdEmZYGCvW?qcda+ zE!&>9Qy==+mmK<)%WV+Gxk061ijZSj3`KQ`Aq2%boHS-zoY zH*eK&CZX-tZ(@3PRmp}lRknBx5gk1)enEys?#dUd&`>DlgW4TI%419*Bi z;lfm-Rx`8#tprVD<$tTR@bN}o;N1OqB38;Rx5V0AaD$>>YOihqs!RO#bDC&Tfv9B+ zwlec)IIbGn;B(tuL!^5bRfF&Hx#e;h;CAEN=d2n)9p!yt&jYI(?Ax!8?Vbq%^*v9t zPhs)+Z5toe!7^o$AAIeQ3@h$IU*W|qO^Rn@iX6Gcjh(bB;RK0B9bSE*f>d4|Q#yYz z(jIl?3|i=nP=x(wn~=*tBF1_EYTw2mNp4t?|A#}(=^~d)g&}08uAN`vE0xlZSC8^4 z>;CkN-+ez7o$QE%v;^n#KOB-+T+)HbB$F3S>e??#kdcx z`yZ`Em9vO%t-mB$&tels4|Vc_j%*UAIcq zaesWRv8x@+e(0s@h2Z>L5M)b?)Lh87o8_MdFLvX4JY~Nz^R;y?G^gIICY)$JaUHEm ze6uPy>F%%P7by%#)WgG zD^k$ewbQ*;LzfHkiC7BG-qrVJ^ZuJndE2O{jPRpuktd|uVrUz=SI~|SQ)xn zTu;_hpA?N7*5_5>a?7)_LvtLK7syoa8ro5^#1ADbQg)Wh_r7{&ufHq`q23!}z8_#* zofwt4y?1nH6{0-z0PCO!Q$v$Zmjivg(V@s-5_h$07TRMNm5hytxM&<>nu$E8Hkh zhkR%8^nafDxud8djO?M4xQYE~;@|mWjU{F7C*F0hyWE@xeMcJmjM}c_E0lFemTHw zc9>3*UU1%>6nuTT@}mh(F(j$l@D~z$y)j9(>9;S8h;%k0kLJkCxo6=RhTdu+Cyg{vUIs zMsh!acp<1eLW?CIk8qyqbum41sUsR%yV9#N)BX3QLu&+2@r~K|4L{_?GLux>k*G z!m)T)yC*H50V00aEo=!v78(v2DYmtA@?9=&Yw)Xq6~m1B7pO~N| zS$##mxE_@(1zDoXABymJ^J1W;MQ58eXxo{GP>uIa6#8%OY}se9|3~Be-^@hZX>o~P zqjvT~=vyOrm7oVKs6L1Nk=>ll1YlTIWK#2AeCgnvyeBa!105oY{4*t#s^&tkB<4o7 zNGBePG9f7snC+qZn0qAU3$yp3+hJ}^HdTAP8u)e4Ak{1os@ZMRe=SB;Ja1&G zF{~L$6=^Lb4GO>%e%g&%7R{X}Wf>l}$&E;)uSry*j=Xb;2DzZJplvv>N*xauntNqd z9j8^WyO#JV9FbX6o)VSX3IKg74(R?UJCmF*06!Wy9DkOt*WDx=#G@l(v)aO1W7U zsQ$iUNCjD^Mtvqzb4sstq`Nj_Ej{t~u2Fu;g7L*IA9_ZJdx}7>&Gnv$l)3N`!Rs`lX`Pc!C$a>zNDf&`lYmlzR25z}MklG%J za5Ft_$@T_0sH~Wi00l9N1v)9o>N{V!E9|L#t4&23m#>}xsBHA*CAOYu-!G<07@jI+ z(;#Ou4|dFNb76anzKOVreUZc6^FI`E?G!~MK57Zczvf)xjgFnspIhm(ZfG3K&3Cq2 zeftfS0Fuic;K<^%PKx$#5V+94gKO2D(yCE^w#J%AK(rQm?K@7Wy=CN z!Wsw>51r=a0yp)9*z#^r=?TP@11wogl{o7@xfs^^Dc|S({gj7xQYVV(%mpuF~GREsZbR7?Rntp3ri{hoh@uvx2^14 zVTY{64L<7GBeHA-hhqdrw+v4uZg@_~V*WkqL`X#PEkmC1T%zig#K+fP-YWhxIrA>$ zqRo%R3LbwI=#9lcIc?>X$ykxTkwU$8;`4q?C1eZxQ=@f$LijD)(^x@!!@+e-TD6ZE zu^fB1dqq~q{poO7{x?jsVS(I6kVD69u7C$Ta9-BzJroC6V9`@4Wky|dN-M#h`$Mrs zqv}ki0m&!W<3TF?K89R=`Yx-0UYK#wjWs)R+Y-)TwSP(yd9KkZxkpzG<%>gyT@G8F z&u^PdYBPG^_|fKIWsK~g-@{}5z4Ql89KUv>u?wpQiUgN_BHt&EGj*>t!iaVz8Es2P z4}L-rO}MmWazw;XMva#fdJ4p&Nusws@gCj!`GCn;*Zfg|6ICgms5c4tIq~ zKYtgc`Q-VFobB1~7I5k5C~hB8SX2Bp4x>Uwi~vidvz^QK1Dx*HGHTFj94~8J~O%|4g9d! zamcr_%&5-7B%T9tJ1j#J1UDSOW|)n(>*LJ5xlw2!&a47ZPVh9Kf7~(|iip3Y5I*Jv zi5W~%{wV2>ZtLHRUFF(nIg^C;T!t|a)uW7q{oW+*C6IknC^jB-Vruw%6In^)R;y3= zpi1hL{&1a?z2_P?m)ias2olxD-4wr0lw-o1t9$c7vD!Ui13yLSi@+Yfqto?uWv}XG zqo-LotUu7^aV;fG0d;v_(&s#(&v}QT>)T2fdc+#u3-uoQmTdTr#_)C86Ga8F@we}3 z2rM?UyK~{OF?E;d+tU(}0^^kf>Kr8n@tXPsPF)g)@ue<`KNnS$q0AamjpQvD(L@_+ zg5!+QNirLvdJgyMk{!{5eb-j$6xT54fzz`UQRBkM@$5@vBWBds(2FLJDs(^}kjOu) zT@992z*iETlFbKpA6W*)MAuxjRw3HKT#^$E?pHe+*eHm*GKob zD$P)Eb|}Mh)!vNvn{(0{-^M*@ix5$VObt>1&pZcYgr(5L?3&!Da)t#FVV2uuur4Pw zs5&Ohq)(`Ib?6X#ykX>wqmf&m+^?~L$rHogYOvn?oAqXN|J93%19_2((Yi^k92u$? zPCw1zJF|ezDQel(wbT9l?n{hXX${F!%;+2ZldFSCUvfzetXu4Xom)|Yngjs-@kB{m zpYVXT0B51YtxKscKrGqrmvi8z^>X%{OD+!R3JF%nBx&p$=>43`hSvxlc^Tv;&;vl8 z9R!(;UMRdR>8BW-dui;MNqVh|G(AjyQm-xOU&FLr zKQ&C0Vt;7R1=Lx^Q(Gxt{|tjEJ18-CbkS&s8+QwBm|K9ZrGO2WZ|@4@#uWHdc|cFa z$L9>omz+7%K+|i!amjAD+Y>2nSokLef@KJYW1}gg)C98QJ^5mtVv?JdTX^*VeNvnXCv5bRDn$Iv{sdpcJd|wRs3a1` z)ZjJLbJ&t8QRy@Z_X^8NwLCC0iO+H6fZRJ4b)uMO?~W@-G;2&jj>G(l2b&7xHe=gG z#v6dBCxt5_VH(OsZ07@m zg@n5nrDyeO?>=p~Y;no%d3TZDEmgsZ^Fose$?eZMSgAMRR3|684X$ab9lEIMBYbj0 z_BHcxZx&kcZ~fHNlKa*@l^z+1o72(~)_JIo&pi01G+A9#k6XVFlq*Alo9H6V&_Kas z(OI?)%#S@Y?)~Q+2oG-byO3!w9X>+o^4pTAuMjo=Q1#p9qk9ed#*t6X0zWG$lmGtK z?kM5|ed5z@tKs8HV~`wY-c?;HRgNng+>d$2d|0af^Pyixbx>0K?Mu?0y)sMYB@x&+ z1(1(o09@!zCeWJ^vP-waIR)QVe+}hEwSb565xd(bA28Gy!+jcKUOwZpu0u-ihMvaR zcQh3`SEGvL+CZ9$x)q9Nf4H6zay}#Unx+$8EN8C}%}>W;0~K#=Agxu`yfwt!L##gH z857Fv13hIv!8NQTU^Q#y-3@gKN-oY|O@^aeXg=&@EY!3F=7t+%4o7Ou1{|(xYK$NV10WuB3FN*hs}U~7f}KC4hP)KTd!m14Y+G`fYQvM!Q#s@};M!7Ua?D2= zSN-@oVASkm&FFL7>qMKziQA(&B1_I{sH&RDsNo3WBgAmal|74|nA*6et$C8ey*A%7 z_19k07YSMS2by!G01bWzsJ~gO46gd6DIWVJ>=2TBLr%|>^O+@nYKYo-7@Tok@J-+* zDsnnSow9TUWzxFVJye3-u5u}*Z};p~5JcKoaT|qtaVpeV)Ht0QtnQLqaw5fM2JV?l z<}tV@jx(E3zmlksbWRU&e6za>WT#V+2AfbdXBp5J66Y*}=n`BWf-NGj@CG*mCIx=4 z@_2vGjCvv(17^<;giJAtZ-iIF8(4=B&kG1Ps|S?P9j#7drDFZ*8||e4LlghiIMGpvjuK?^DPA`Mf6ItXhBrGE*StlTsX?xRn#^9sialkG;xHMayPKR* z1JWUAc8E-w;K!s6D;PK4SlE$u^i-z#OPNSj7KhPpb$l~7xq@IW5p_B}0n=gM*KMk5 z3A9V4&`hJu?m=d0PQ{VOW1)z~WT_eZsp>$7j=Aim3d3`j1tYhiRn~x`*VYADoQi8- z!{ULfW#IeTBGa@392ZDcOJgFO>5z|Wy+FL2AEEi_BigS0eiga0A)&GRXO{FSSLx*& zZ0et{ME?Ol`G3HV-%G>D&)CmF(a9Y?Nwi`{{H*t zV3D{oUP~A=Y*BPougy=RoCa`MQAfxjzI?$rAQOquK)q(($k+#|T*p!43IDRGPn>im zYM#iPpK)a{iQ1^v8Q|C9Tbp8Yt8XrdT1z2%8jwaqz#vZb@G&chK;{5!qaXOxi<4NV z*|ad40uFFaVkI4KwipfZ81(F*qRvm%qI7yJJCaL3F!|*E3U-up;HkFJT1pKvv|PXT zwa=!mxjupW+K2PR{dhOZgt5+h1p-G5sbSgU@2Q%=hob7jM?81+A_$y$lnhHec0?hn z+wz;+h{Pw(EvEZa6zn@csL#8*of3)GcHIb%p!1xlT)zkBs#TNS*Znt|e|vt*JEn8s z5$m^t1Z62zRpV24w4tFwCYxvX_Icdz{1tzlM^{WOEc93E-9X(tjFB_iJkV_^c{I}U zYvb}wSFI%<+uobA+VQ8^z7f&~>Jn2pzUrmPH&s2)F=!|<{m=7&0N)m#33||ee4o&D zP56kk^a1B};=R$({qkq^S?d=H2%v(H%@|Uu;B@MysXO33q7Fj1SK@F`niRs5;nOl6 z<)f;qAk^n(>>~aCFCN- zU5X#Rr@4Rk7OT2ZLqdOsoK<4QTJgUi;S+r{=6u-XR)ys!<@aA6ygIEz?oeG1bw|8Z zSo+49JZl9vS}VSx4juCZdNIK0yGP(LC85o#IM-cCxAci>|H^zW>zm5vfXmFFXvXWR z%If+kXMn#aVg7(8c=(@{t${;4K(2Ui%Tgbl#@qW9}ATtm1g|r-jch8r31!k z?rS>d(^KUUycw@D_nk&2L+2WrH+l_=!bab*+p&k1*&_v~o_g!FR7RAFb^ zYJO!t{kMYYG5lG$xC()(ngi##czE`=Q4y|~_Vbs5mX5yin0natNSZ5*^@kq2EC=<^ z{nP|CNDw>|^IZTTW^q7B(%*V^Su=7v`y$0gcu;|Qk_jK-UX2v!PL0%%Sz~}{Yyk?S zveeXoOakCJ62notvyZ^L@>`Q5rg{TEed}1`)Dh*+3f=lNbCFfehV%et!deROvFBvw zPULh@-m1oR`_pqQO53vTVG8|>mM-%}Fe1wZWC(KVVHnxw4!<6O$Csxn7`dC-yVmy8 z5^o5N37s*fAiU&N+5Sz6zTRt(EYejJf@Atz|HTvTn$&RC{N=kN`;)(T&o%i?#_o*J z!~=zzt{%iV=3q<99Qx^U#5JE%)#Y^wUt*i4Z`=Wxm74JK&=PnQhpK!!DDNvuMgl%O z)8Q$a_8JWfQ1|Xt5?ilqFO)%l47u-m?NEVs}=#oiU?9cK>*&je;lpiwzuvnZuHS+?sWoCfrDX#t8_ zF-)?h0b9xoLl6%fz;UA12eRre@3o0G6|Rp7ngGFlM7gD1#(`!8g?e`xupQ$rG7?ZY zYPKtTJAPYyGK(ZKrGPAttS())tcf%T$q`=F*GXzQ9Lb3IF`w-dF!MPG$s^1r`RZ23 zX>1#~2PeMD)B*j5q&FLBf-TMlc~a&tFAd*dPr;ua$#0p|v-b_MqWazHq7oQiJQjX|@?$FM;}qV*7xMG*^0Vp&4u$M54J%$9plru&P;2Xw{`l z_+d+lxBc<{J@8alu$_|eNWK1td?dpl6~AMrb*$<+S1;m0YO%&GnmTH3`$HS~XT_=m z^(&*5{Pn?;GB^v`;~LzTUIjoR>S>`ul8)Wr?SQq$fYM|*Hcp?kVeOuj!HDBvCDt`F z3`k2eUB^)Xq|Pp8Z>SKiI>rk6(dEOWO^k&^lcQV z_2poe!Flp|Tfh3pHvUq;ws9qt`TH=RR?AYIwQg;q(3tv}SKD5J_r%>R;5bE#l#l$~)MQK#Sfv9*t<{o6mP~u(hu_}I^KjZRm(u~{gZ}( z_(M`T`1q^$r?qqfE&O#QA0f$v6VGXlFP`MMubqc0NeaaBpIz2H#97U`nMnm&ZoWtFP8omYo2cIYY!{>j>Da zv@kwkx3MjBkL+hksw@Ofiw3a=n(=zB?eBc-j%%hu*}&#gj;j1|?kzj|Kh@;QO28i& zl6{NnvYlVl=UW2(PjT$aYg80_`O1c&v+kMNdBMq-eqGgnv{V?Vqu`Afs-uZmA%)Jv4|W*-eoIZ3m!ZKa~{= z&O+9ngrg=E5NKd|%VZ0Amrc$hwwOtouIhOed?0Xv;a;dE~+!t|UKpLG0?_0`) z-p&|$`N~3LG<#f8=vRdvr&5|vnF^O4PE^8bzy6`CUjAz-KRW-S zF$Q`ahI+81*@TrO(NlNybHVXuH>ouGk)dp?e^Y4dLsiKw75$v+Y3b5`<1A9XC}&lrK#1&M$g#75lm6Pn zhetJ)e#2j1ND=Q%R5UE-%+d-%IL;11mda7X9KM$09U`{g{Yqia&2Nr2tFNHbu!Td7gQJX5G zswb7IId^)3&fPaOaZ{k#-ksKro94Y>o^(~P%)18^^LI_!3r`(iq{W0u8FdLu`zwQn zD72;ks7rZ07xb)+$=5nU;t|hy3VAAha|3Itm|)3A)^w2eOQvsPUi=VcdVA?T8!5wh zsV{^w9!oT9Tr!$9)fotVIi3x{l_c|Fc6viHeXXmZ7|~`8916H^rdTy%^ODD|#!v-! z>+9Ih`;I;mzj!f@NZu|KT>1MS)K2cjzhVvC*Yhx||04pwqM%)NIM?$xUDPc;VX-fIIH-Wd(&h<~3v$ z1tmQ}o`9P>y7T}SAC+Kea*h(HAdOyLpTLsVUbwx<$M~Q@4T)>mt6JiI8lc*%|14ge z!ANc6?5YI^lbPxHhm-A1ck^V-J8UY7s8=m(g5L04CkDnfFb^dSs8>-J8S$3hxe7^I zPWps<-pV-mh`LSOGd?Q*>{ZZ3TA+bo+e%E%{feGJ8*S*=`zX;Vbpm2U22HOAaCyT} zt>BGTz%{|hFD%MIdHNYEV?F#O)EnXs3`5k4J$&`$;D$Y7dMc#boa7^F0$rmWzL3ecsELI4(~!=9Padp+}^@Q({$LN}4jh&zt!#VO~bRR&k!< z9jN#qNq!x!(*66>TT;}>zApnu(Rj1Ii#_)p`?>V?KRQC?|7gXW0ad#;B{rFa3JvGv zQ;kK*L0CXdLdiqYB#z+A)e4mIO%))ydU(uCBf)UkV(CW)WbXcVX`VYQORtRqxu)zJ zo3Z4&$z+Hw?zPd7XK5GmcFI}gJtC$zR$6qXbF#-vb3kdFix^-yR$VCl`2s#e4f0a8 zgl``+E;(K8!9ekhq?k^emsw$ks(v2I@wCu@B`VbWaDu}OlR`h=n_7y-;eQ%%=iYOsq01LY+2%;z@wX~>ow}K!`cSyG=-3?1hcXukVE1+~Y zEP^cU()sR!zxvO6^JaFOJ9y8%=gaf;txbKZa-i{)Df6p+G&7x`yZlJgXmW&!uZ6lH z&EdBj*FcpcyUFYtJI@ME%m)NVJ-${H%pdyMpP{`Ps+?MH_thEUuF=nC$nlM|r?X?D zqx$Co)5%gY*ptUfJ?FNA0oIi)&)8^+4QS~NO;?19#~CXsOk@=JbHp&kivwtKX4t<$ zqK{U{e)8b`0U5cIS&zO^`gQuX9IV>Rg3ZO{(Yxw`P_G0~jQaQE<0?SDibwO*bQTNQ zb~|2A(EAFY;CB1b-#SFm6$3nG*)t^(rHAeBKo8tT)e1z5p)vQUM9n`x9eyXJCDh@r z(}M>+NfVkllBgWA5lT@8xiO{7M1$?2_5gKw9mFfjWm5zrQY@ocN9tl=4=a|JVyl8g zT*gzo*&n!W>m-qzzm^?}Ed54G!er6wK(fzpGLq2MOvT8)K1eFGD>v3euxGHMs#<2- z%~!m-lt5S!=E>lepm}TJYp#>{A7KBPPU4ZU$FPX(a!xy;gEfJkG81b>RUm`g3^&F7j=u_NIX z1ctv=7HMHYb6Xz#VYHe8QRd?%Y;OQpTkq;)nN%74XLAD!dFtOKV3o!p;J^#%J0=H= z&mo`cb|VsD+7k62$*q?;#PjOMZOrnNCiJLaG1if`{Z;;oBkTx~H#7vu z7ZRX-ML>s_7FDTmZ7y?j9lq2UVMHuZGI55W)n7H|*5*UZAI`x|45cMUk?GnXU zX=FV?XX3eTQtWTL`bf!61ssNPWR6;DRtwgz?DEw=b0+Ec=o}&4QX0PuS8rxCUVwc9bOJ%h|2zDQHFg;Mf4s6lFMC@x+)9 zr7SUiU-pq|r`+0MG#Pv?%1=xnb5{iTs7-`^RjzbNzgs|r0~e7>F6641~R zv?NiHAtMQ~OM*@>ZMV&}QcV|c6+{;jUeA|K)xuBQHXd$tr$HZrY3t;7a!r zN9Zr158&7cL;-*=nCimRQ(d9@zh(h!d_8w<4m3AcG49B34kmXWM*2soNR+K#(j}K& zkv>%@BUX%bPP{&$0ijpg4NCg$c9<M8mw!dft%2 zifp zEuUHP#?+B;kp{0l-5X|^)FEtca3OD0Rj%Kg15oEc77&D6m+K{R9$;R)@{zy<%Wc=6 z0~-B$Sy(b+_3GU(9}SbUNv6J29>@~o55Kt6DeaR9T|+-(Lb6lXvI5XE5z_9gJ{rzt z2`-hlzcy7`E@a*bTh`17;yRQs+jy8iUda-*d}qfg$!%l-9>ga5V1y<@h&l!Jsi-sN z&?tRJnRf`XdWCjX?g661xiiH)tm2a%mGgKD#93fe)};#g#?er$d2b(!WW~K0w1%3; zxCp`<=6~o8l+y$HU16LO9$~APYi*oeC#xY;e8>yam>7y)J0?=fS~ZsP7*|vj3K*o! zWj{1H8-I(wZswRAM#1|v%=}?FkcBiRs<0#7KEb*#M-b<`d|PeiV-k$!hLM?s6$zdU zu7F+-lrSk!l^g$qFQX?oQ&z~k=PAR&q#6Q)b9_l+@l{unJiJXfn_0AFR1r_+oz|^K znGsW8CEd^$ZO1S#Kf=ED5Qv(yPdv=ue%W8d_jFh57nvt){YrjNdpDrPj37T#ca0!l zA-O(Vw8lmngs26%E+181nlgRd>i&|6)ZNWA?L_V!t3dtn=fwcugbo{Ln?FSLat)6$ z>Ra$+X;Uk8!LFqcdGnUBeB&{!vP;@2za`|$CODA}W&;fJI3~VdM(Kim_M=dkHM0tg z^3l^#Cb?myAv9LD+ z8LqyrHfoBTm$MzMN2X)Jt-o^8Q{v~c#eIzB8NNZGGKjSAPzo=r0rm-|_{sE-0u%B@ zcJGmq+mWTi0YjX+%ps2@5dnwl*;<)x`QSVPK+7a;-rW4G~_l+ zJ49s=#-GCop`D|{+zRT9WZ7J=WrH~KDmHioLn7G^O_I2%1tcpnNp?G`D7AMg^k>Y{Gm`BG~ZYDpMx~kJUTlJ17F;v5yBQzw`p&*q9`d!7>^4k}2xP?8Sn9Mf(f@kq3j0d-dZgzd+WKCXnvZZC*rgauRvk&J- zwo%ZuB8s0x75v*Wyb^Ve=4~@$Qj? z*o-nrcTm7*XTz|^T1_IzSRNh%w^i0+TGld&^X~M_`1Os$&st;Yz^?@`pm$s|g;pzq z>cBySRHTS>p_LMt#)EBYxvn4)kT}iYfW3?hJ;_RW1kDW35u>R-0qss&ab6E-XP+OF z3PkiO6=>H8Bo2e#lmTH2w&y}!-h{&%Az$3!EhYH6xW?)pl_~FkUzOO9d+TD3_*lK` zw$XGHfHw8mu^R)iG?e7@)Oo%*Ya;N7BZX0My=5Jd+n5%(xr?e!3Y+2GoTVd;JzlRn z2{B6qfn+E$GQSWj@E(r}MaLyNzi#B?FKRk$zS&4reov977Vx3PFL|u&7};>&)0H`_ zmq4P+{_+x=Vd=5{oDA}Tm)5&mO5e32y3?~%%NjjAJls_Zp`mLh*NDmE6Ea#y(LX}@);n7^dB`kCak zSD^>0`!cC&XXU!PwPw&up{jBcD)TGLio4X7;4Ua*REMU1T&%l~dPs_h`|bzR)4lYR z!oxliwu%BSwo@MTYT$|dZtxFGAV1S`8}z}po-~}g-@$CqQ!jFuOt{|{4l0*CB>C`R zOY1bbD_{?|1>CX0-C%5Jk2W?9b*kj4H%}hLJ$dt{)V;lh`sOAt9}v2y+F;JJW$YYjc6aHc zb9IYrDZ{#13-w$vJKwh&0BnzAtvhoK!cdq6;oZ4rCw(RRGf`5#{m{YAm`dW%!H?TQ zuXA_3p!A5a8?gH_w1<`cwB!!r!*i)oi=CgxO@btSp~N&C`os`g-vs1GJ(D1nrk4@c zANA5h-pzHXXTJ;i#&L**>MDulvgM#CM{n<#Wz!7G@<~=2Ld@Ri`8&aycpi?Jv|GCS z>^r4@#OaDEc^MyZ7*&XtM~E~(?8_>ZhakVW-w51dN)zQH`K8`{>o9-);PX=4A!8>E z9(gVgNfEeHl}|`eS_h2Pq%d==CS{D~|BA}qFN1AIIuG6~GC=l7X*bZ-ZyipJot*-o zO^>{(oh2hDkW!)w=Qit*<*Rh9#@+S~dFh(Qxh`0{hX(r4t-aGB1e3=}^%)x+k07lw8wvtH>;Wf6~2I6!1~v*A>*+PW0N(l|$=oxHX; zk}3TU81eM8&$9EWIoV$84+MuZ%JLd?x(g<81#vLk;%O)eMvz<&o{=)_x)6v{|S-nP*=QCCEBWusfYHQ>j^LoN7C6-;XITd{a&GwRb?! z-!?TnGIf?uded@$3F4wTLtLmpo^P`Altp?t_@m)h{?*@@1+mb@ zJQ0jqvvJJMWWwN*egei?JMw`i=4CTHVY2j#dL(UWI@Y!GB;2M0q6F^mCk=2#$sPA0 z?qQ9NT~bnSVPoHQbQK~)n9HlxvztN+P*R|f%htK+dfKJ30{YT%BxTv!V)r}zygRxZ z`cK;1(#KQ%?JA#i(nzHlspiyAmyciaKS3ORD_^31{@brEj|*LUyTFtt=3b>%mx+>! z0Yqg@D~dWj$+6rND&Q+3*+j?nh6e;Uti=HpYNbH*}BS zP_2s@XZ^06;26bq>!+uU)py{RJhtL{^c=Y*`190X)>{v=xE=9bv)E`nE<4Vg&)wHP z$bVB_Jo(=CofJqgi+M*j;2n8}OOu_0`(CI8Yig)#lE;!zY5h34|7$mzTVPI=%F?tY z0oQpSGOm|`9<6trhoe!gv{EV{b?+{9kVIfTco9|jwpv%IDJB7&q$2o7nx`$81BXs*YaSzhb6KQ$#GFdu{Y)`Oe3?yC?!!ZwoNx# z&hO@c#NA7kNO>30G?36jTkVnm>sn}P|JH3{&TFp9n#2Q=6q;0_Kdv=;zX%S$)I9GE z=`NA*{LvkELv13DJz{6{c$PuB!uzye>gkWL_mKCKc1r@a=8tZ_A35F{a+;@t-^-OD zZbQ1xOBE38}Wri z9h&ecYU;zO$4j@8cRs|h=jK=X&#vxhN}r zQtK~CD;ppMi+uv5GiuG0^7}ditH7V6@T(y8bPN6rgCNHQb@x80Qgv-9Aoc=dGcfb}-C}S#V#isB!?4vS7;Ei6 zX&32t)0f(rBJ#rlfhoHX!5|K^o8e4c++mIev}(O6CxI+In`O4N9P30pYj~~AjCgJ+ zS`bRmioi33)V8%=#p)MSr~Ha3+iKEvb>EskZ@bnjc*8g#ay_oqN&DmDv36>@D_oD} z>6)#kR}5~tZufEpnNCnmL@s@+9MOc&y<9DaKK1C)e;~^ftG)es0MpZDu6=65CYG4Z z!iQ0UolLOh^VZL7-DuhS#?uT(95g;lrh*1wbujZCZ1#J^*`*3bzqz1b%0f6(W8tQ1 zW~AIE_kfABLt}0@-{7~xn=pB)<#(+apa&Zq2mw-7rh#>8e2-&-OB7B@04TE83D4{%9s6d9vg61DY$=z5<~l zRTbXKLPI^N(xF275Y&N6mtFO!7k@d zZmu71f?c*dwVhQ?1&J8?XLg6H7h!`h_7C`G!lWzc{Ifx1qk1)~qOo^E13JrW%e9+l zKlGytPq*_-uP_wB60dg)HCM!c!9SUpIrUgz(PmWUe;o>E7SDjWrWdfBo)i*FBGh=L zHTkooxM}BWN=cyh{QWCa5XVsak!qR|9K?w0aY8?|MZYEfH=t#~R>+?{^9mLMt(KKE-XVmu))hsHCvS{A)p%2lftL-A&B z!H&i3lks6+r5HZY-y&t;RY6vblXpBjE@2tw^kkSc66@fS+<{Sq#Tmo#I4zGXb8yMQ5t!lHbZDE^FGBFu1Cn?kix>!k||53>h3#FPo$M2Hnfe zWjdb(HX{Desvo|TPY)>~@l z4ipo%cA6=6DiX|y1DH!FfA9RUIpnGT5FLm_OGa8zB&na4P`>;og;|bLwm%oTA_@9F z`cbR)4h{K^nYW(yph|m2;doyR+bF5t;7g&(A+9F_SD+zDbvTM6Igk1ZxQNu$#E$Yt zfy33jvUoJh-6UJTGG3jx5=^mTX78nRtW*c3Tc8d`YiEao;We^3N@7g1(uYctN^d`c zLHJ=zAPaDBDAynox)WvQE7WBKqf%TcSy_^D3BJ>nbH^h#%0I?79j$FG18ZEMI=d1> zt;OcGi>(|7dNvr@S{X?Y1Oc+2V-MNF#h1M59~_!L>LpR6_>nhK#!%BI_lS(hrNQhq z%J{Q3DlJIt=JH{g7R2MS7W(q==72j1&7|C36Z??1kgte?vY2+G)N=|{pT*H~_RYLH zIJ;G^T?;}!K!(h*?StU!N0nQjZCyJ8eO->Jr%k^E*0MGX4gFr6^%Dhm5~p0ZSe&Dg zG#9*gmn+CIq|ZGk#H^tNe_rdhOf!7mXXWb$OdGabAvF`fu1DTz`4>MkMI0WkBfW}y z`#_4p*a@jXn80Z$0kr3V`+E2bY6?X>^0(q9Z2r8%#^o~)SL|_xEbv)<4$Fw^M!SJC zsl0YyMaW=zQf0r+au40D_Ocl?4H6~_;37aoEeD=GJ$#=zbSk|u;{aA%(@)( zg86N4(83eiVJuXTTo4${`lH#yXWv1Eq-qrrOAe15fcZR0Qd?=nV+ZNSM zff85zO;|}WW#C%xV}~KJ6f(55e1G&#O-w0?%TQmabza6{?<+Up5b68{FH?al^TD2c z4#EsMt7z~(4_&vQ!^Mz{u@dP5@YqXxxX%nc`M7UWk{zoM0b_vG>+Z+a9$8$B6OIv59X9e@Kv69Yxet zA^9E|iTcO-W8xNOs5K9YQMxIu;%3L2r83f*N+c8nRYL9st|M1xaM&M`JT=O5`Q<9N zUwdcJ4m2*yoxSeh69{>eX2xP9Sd%Rhxr!TkVj8 z)2X@NlZavLh5E~Wb9W#zBDb^W$Q$FJNH&qBrAQec&PWW%CRA-3roY=oBj?>@CsRQ~ z5moxOy35^t9D>S~b*n7k+E(KIraCcXsn8iNmsmWU-zmThU7`_M2^BmxI`#88-Vj*| z=yOz|E4rUaqE8?3TaTjqjetYtYp$-tE}4#_M$o z`E07E+$vz+_8Lt*@#EQ4Wr%rbQ$eT{0#m4}S>%SKoMEbYw9n_Dsx6}VI4f9MrxP2P z?3~(Ld&C5 zK(`BTI{)`H&{eeW4}3F&yUP_zd^6u6QpjdP6C|lOJ(7*5mfnl8%DG0?3qC zI&Jqs_S~wyo4C`~JWLTzViFDBOMo{nm1dR!GN4U(|4~fZSlbc*)*@1dwIUNN`pGsh zg<$&(&gWp@*yjR|sCE`36Kr?o8gVHS~lzEb# z0yG#|OEd8nS)0sIb8sRCd9u<5tTPc^rFpb=c*qeM29EIWKg6T`tY@v3ocgD1ubs?> zU#-Elv1Byf1j_Z4-g_@#{247CqhF8GhaRM!rupthALl|;ZM^l4b|X3X4d!36Km}SE z2$sBLNPcp#Ho3d28_WwZ>}VMBeP|V185B`0<{A{qOLor-U898$UipMBX?iU-+8^$x zVG?_-#%AE5pc0tn>jMYtT$RC%t33Rs`lj|6kLG(vE5)ZOO}SneMvr2pLL)AAuQ77U z5tY)ob|5OX&&(En-5-DRI-iFSoMs=ySA^$aHM@jL*?+NhO6?}sW#mUgv$K7f86EF&IKHQ8?YMc4=8ShTa2W)!pQjQGBL#k9KIRoqZV0%EW z3Ily@3Rh=~i0Ii!?SW!W{0HuisX-qH&vrLhI;S_Yk`Bx#r8RF!a51d>0_OQfmVN0N z>bq+6)xl`@mT4TLWjHhK@7_}7Xfm4|Yt>-3pu$I4A#^o^`Jd0)6kJK_%vE;m;B}$S zU(;jiN_FbXGLN4Is>{9C$o;CN>R2&JM|-`|b70 z6u#@5c88gI|2P{$t|3^gK=P z!7?p>%7h!L*8z`6GHkwE@^?E_M@z{zfQ5a8ZTLy^zCOznFx4mG>r?p80jpbv-IYs` z0FoYWlAmsRsNoL^-6F|?!b*PFP|VKASwwNw!n{jk;5mkt*fXvCL0C8Y4}0nLDg4Ed zOGP;+!QIg^ka~2d>uQb3Yf^gQaJ{xE8gbWop*UocmF8(&`2CJyiI{uck-mGy55C3q z4hT=#pzv+)8$7v19zc1AB8Zkz=6QJmJ3{|AsdKlMU0)OO)uEwK&?laXP;2#`qdc8A z(Y@K05?5|JH79W{P)gc7NF}(t41pLONXO1)fr_*c!L^~|G#+YnEeF^x?vDx76dJ>r<;lusePB(`1Iqx10 z5{7mq@?E5Z#d?dDRs!>g4LAdHo$!6IhyeX~iPJTNW5%@z#u`&1Q2zcG#Px`IXGVhK z_k{sHH+!yAW`uMfD3+}y3mwz6d`iJVtM{~S@vkZ?E)jE)&U-nbW)ZBN2b3j!L%f>~ z3Oy{7628y}X6jiVpMrT}H*>BhE14l{KkcRc`hp=YIEZ7d!0-pawb5@>5YRc7c_6Q} z!XL1zF*b5`XzIi-=yPqwcjFp_ft3_Lj>lw0JzRPCjy;NRevie;aF<}i#i1wNne~p_ z*`?DED?GZHxYf4wqQ=xz* z;3*CCQ;nDH4~X^@rig@optQ6V?_~DVV%PhI)6d#n>nF2r2T@xNv@2N-$cKS08}-?~ zJ*oJ)O-Hz;f=+9d0&vjL-bRn$@#*7={P51vOS4&bx=l~^wzkQ}jMk~+YD1Q-*cFmfZ-|=PoKQ}UZfwsaath?}I~&p^+hF&m3drqL0j&)S zaGILK82?9-3@^wy-f9Uv{6dss4IEnEVfUS8+!AG)1)qKK!@o!2$poQK+k)6ijvDDE zsKw_#MWo3LVjdYW&?{}+^%Km6Ms}DD)Wu-vEs%cXyKMKayKk9bbc11EDRJr~U^g*z z!@0guT(o$RorAYRMOJoWeZ}b`Ip3>L!H^vFPMh6$MR(3Pegxx<2P@56Fo7psb+jgO zln7m1!6SCl?@AjZueQ{-VSMaezi^{nJN9h3z^#kV1vR2NFUug(KiNsTu9MnviRh+a9mJ2GOXvp^ zvNn*?O-IK4-?I%hX`VkmW)XDXN+k8}jvpoErd1B*F-&r*%9GR&flFHW%)03A1p_H} z;>5_&L|`5UDIpEOo-Fv!yq-N==F8{3ckgg&MAhyIo zC;UfE*_(|-{yzu{@W4;n>Xmv)5q|EQ+?Q=dKB$LkHDgjL#yi>1lGuvAc->mJT6q0| za1{3BAY!xmsJ^+!PJO_kd5=^Q4%)I-t*JLe_M~V{(t7W`HgetecEH>dBso6vcMFBd z@~G{4poE!j9u`Au$UfMc*=+H*)ow?_Ex?Z8R?;({`2+WfLhT=Cjj0!n97~s2ey?;A+kHe2)F9kT=H`hxO8mVF#4ik_05_rh z=f?D%pi5lb-Mo9T7!7Oh`Jc^$wTkOrnBTEN_tX6FDaqAH^-X&QwH;8By9u^EU1v(( z`Da#lI|w{1EH)3;UY3hO3_B?qn%lZYcU5)Q_H56!_;U< zegWq)ZREftb0=p2MMuh}z19q`cXO2ntoNk4Ol7|IzCd$4v- zYDr};@vDa}>efoF`BI)8jbkDS`89sXy2mds&En?w-Xh#2v)*U?7(Y9-68YIXgZrY~ z`<~}F zpFo}Y=mO8;LS?g*>*Ou4>BpU~sJ#6>f(}xK*0LwaTcx!)zBQv6Exho(iCocB3@p?@ z{P(7XPmP!Vf`;@gohn*b7qTS5Kksun^0)+*b+fYul)3C>OGYpg!fv#>&-cNW>ezAJ z3rBr%NoC2>3q0%V4b)@PS|#<+Qm~DzO(%JX=>#X&xUA{V?St%xrMf$dnS~bhLS*Uc z&4B9hR3Ngd)~;(GDGi{r-uUdGnzPBWA2lV*ty-%4pGCF>N4SUH znXua`S`8p|=h^UCBIvoZTZl=Q)puQ`Qb%8Jg1f8s-ii2DlYh;jN+*$rwTEYTe_qf!hp}|cgO1!4llm06`*_U0b`qk~=(_qov>pqZDILcEA%J858}M?2P`V zg=2&y<9?^CwxiDAI=!Fl&F|OtPV2~rWLH6Kf=luQ{-GXPQKWBXV??WOk(YM-HFkb! zl?YTKbd>Op#i&kjBHj{_As<9tB_8oA-8)HT@jkgLCFW^o(P2aPl0#=f4mj+UTP)y!3? zbzOK1J@0rJFiRH~?fk&j3|4O;ESyb1;otBm9;I{k3j}8_X;tx%PFy;}X{Wu*168BO zSa|b?Q%B^RzKT52VpJ%UkfZM{_4j_9QA+qVm^6r7E#_UiX9V5S&}e~@E=-toe>sV0 zJWIbw%VbJtq&Uf(niNFt?EA5*R2tMcPiyX~jo(9XEGAzpoGtVql4?>XphJHe=flS@ z&nS>=r9E4(cNslpLPQ+&+MDV4)xv(YEPYA|bzgdQrXbxEy+m+&dzNNMCbeTv(3N!N zaOKVK{Q6P_zdMapZVjzHyA$JWM?p_ML=X_d<9CA)1o(?bB_ySqHCnsS3=1Ge3+1^w=%Na1i zwEgg5icuF-U8rR5^q5R}-yJd4oZH5=#w+_)^FyE^dRz2NKin}5`t$})cHI)r=roYH z`9ZexMyP;l8pjJmR4O;^F4=<^V&++?eb!mCc`$cy{Veat&1CO5R8GpR{Rp}d!cY|d z@;=4uFXSjppCB%e;r4zneEl1^b}vOGn)wVVXVLN2elfhhBI}?riY6=?8&lB1jpydd zawP{8QfJFjDj)r=Ei)Lyw{S}2ko#5<$=h1KBBpy_5{B0Jn#t)}Xo7?}J<~x1M!C76 z-#npXWsqk)N0j^)0fbj+QlHLSAEZ)|2DXc_1vzcUHJN(CIZFC4ehxOQO_DM%V8J_m z8bB%s3KBQj`0YyGQrlJUTI1hgOTl6D!A)>vC>@x-^m1zSk{v^sl?ro25~ifIZ@s)d z{h|P!GWt?eWXV0CgkP=cXL2|<7p3Lk)@aXp<83Mxj!-}zm5>Wu7=~Lju2t+Prnt2; zRZmzmN45d>OS&)d<0IEZ-g~p`w#Caus{{B96tU9XYQt1*WxkipJ+ zC%zlpGXw}wenGhtIik5Ww)u_StNag6F zUG}`t1yExrW`D{wb#NmYu*0gby;m~Mt0CvUC{S+w#(;X4XfMab-s9-8 zg-~@~LLJu7s&g+y7~9g+uZb-h{rjcBg^}=|SqH2S>an9BJPE(E;h06N>`7eo{vsJa z_*wv68>|2}OIf9s{ee6F`3bvR5U zI@G4Ccy_|)AbDlpO$DvTSplOhC@q=pI!9pd?Y$4Y-l$L4@!@|SQSuNU5x+@gSnzUg z#pwc`XLP;Tc{DZLFiT79^C$^`jCqjvXV^dBo`W6*fUNX&?mVj=C){=QqP+ge8);G` zU{d^@*5mp&p1nH$N{sPIie0F9_1n0kR*)rZ*IDe(?_2!XIzMbzg1Ht|XxF(gUCe!H z!C#EK=xex+Pi-0!?)d8h5DuX2h!|))0vfX5^c;yX_1G7BWnvq$GPRuLCjavY2C)k& zCrk#>j$KIV53E^_GQ)OK4lO#lm|>qOH>zJE$w~5)N-)sNnb48l_`L!Kb)ZI z|G{#Q_{Hp!mwVKvZF8eP{(vKi4>%&rSKOIO9$&mk2|HOSSI3_5zc1GOL*AdSFZT?e zul4-b1P{L4*XLtTR*R6E#A3cR673#pNk9gU2Hwa>}O}m|2%=! z^rAm)xS+Pi<3cLzZvfT>Fh_Bs)Cc?tAf^p~aD+{9^F?gz@6{CdSc@`9xi}HGOz%_J z$zQCkrN5Ago}Upey}+&4UtzODRjJ7#|G`*=7q+AF?JW>D_xtqLpFl2}z;=^&*0yCy zc!xLDY`EY!gxID8sK;dWa>6pGlNRsA6bmeZ&VR3^g(JnWqiSw)-tL@yW_|GMn27c7 zhn(5owFrZ?HZD6*GzY#uR#{Cu*T>H8l%4IyAk_<_kSV)~s}XX^;nmzSP!;?6D;Mx)GPLj!7Q1!{jM43#VuWv> zZAHE*i%qKCoq7SYGzOcz1i?ET8T2 zREs6ecbp5X`!E2+NDCkP@`nn4$f0ushu-zQEi6o6VygfXdVKVyhcCPF9Cl#W((p@7 zGYzF|=IHfvC_C|wALg->j{Hr_iwlIXPLxbA+xwLpe^`vw8h3gyjz`x4P&7KYcv#o# z?tReTXt=l_k^+te*E=mGY-Sh7r4Fw7gIVI^s-hsIKA@nOu?mX$@tV`cS@mai%S}R~ zuZE)zX42Mi>z#jqd38S(v`=@rB=Ve9h3T;8z{j5MKf5{K1aQrSE4!bOqki5Q#ZYn; z|2@W?Y!StaeQ*muHX+Sllz=olKgs@D@`MrSukO0@t@V#R6z|EsA@<5p3`-J95cbd@ z&cyqV0`(*e^NbXv2OJ&j+e`fL8@!tR^3lA&P2VZ7nqa`hso*~wVU_dmFMh{Na-<=KR%hN&zst59C3n_O&alKLwV!PQsxlg`~ zZJ{FobDvKn{ag1vyb1`Ko5I^DTrQ59T#;PcqYk--FKPUm7pI^R#LH0VXe?7?>quI^ zqvh6xu;r3((t?!Q*Si11IXYW}cbC1r*}Hid0(I+G{$Qn-3%3D}43&52ZaNVs0LDH5 zsO@$~BJLL#EnRfQ{6!uPhL(D61AZchzZi&)qUF^Uj~g$zd0&y3oKuO_>lGG-S5uNM zu>1E06!GJ>=Tr)%uNn*dG)(%V<0||wHC68?z3SK~;|d;tVGTDgeY#mOg(njMF6Rls zzh2G2dKp(5nC5n~OPX9k=+j)yUs$4yztmj(P>e+H&+ALc0MKEg%fkO5x(;r*Cxe%w z{@aslLa`&i;=OtIX|QTE^<=4K{OZYh@4mE-D!%)oHWXO^)ke5OcsKXiWhZR^ZEWP+ zwK`thx%EW#j~V$ddoAPYzJfB-qjPKaUw>w%_Y#7;!xm<7ufK>r!= zUs?5jd(#d*uYH9kY7r|QCmsW9lZ}DV+FOJM> zAxwM^bBd8fW_Y@0-PHDXE7ZaP*d)X&dm;}d0L#N zu1wPY92gDq&rPhc_{YCDnONZ3U_t%a_3nQ(@@rWvJkz*yA;CjKLk*&hQg|IMg>sfJ z){SHE-%r(gmD{bnhsZ3(`u6-LvYKJ&4f50mPY0zmV!=;k!kH=Ui%LEDA6zVc5FP@C z#16&<{sc|jt@WR?gMbtX{zboBtd%erUN3qstA8IfUK%%g9n4Za7;2PYeO$34SD#!X zur$i(c3k;ehNN|xuxzIEmPIJQq_bt}FEIkNRYf9DtH?QZdA!-fWBQ%61)VX(Zh$u4 z1qSAAn1U_>Lgg6<{cg@$C^NY|GY98!|Gt(@^PaEQ#RIwR)w{> zr8OKo-~Rzq#~OP|T8|8K{IiAgsKGFO)e&R$s4{ELdngsx$b13T04}dM$tsMSEPT(*G;Is6y zLL$&;lj(Ou2CpQA8p-Oijc>GEAs&g>zhEnMoV|Crfg)IV{&3P_EEb+WJoXRDTkw7E zVyQxC{_$Ozi(eR5k|=In_v_@=T*q(!NNY(2)()wV+VKC6l5Mde6K{m2KPoK*fu9y9 zF$T81tL=9EBqqDUf zpuaH!hjRhoKU4eS7T@BE<-kRk6Mknv%N{TST6WQcSOD)|d;HPP(>*NbIAsEx zV8U~7_=mW?HdtnRf5+(T^u)@3kl98Um*5U%L&&#)AUutCHjY<5I0fA|b zN%s0@(~dwQ{9i@|77s0oSRh(5;#V0i6`JBs{^Wd)>AqLFsOj<_C=MuxytbkWEQSnZBWOAc`qo@1rRF!~IF}@_U=z-VGfF9ft z=!|KuwKd#DYx7piJHyh2`>J&;+_q}^&TSc;7r5?D`+l>l|FzZ`ShcaJrWA;n;D2@x zm~vPxGEai-AC|B%sj&NQKI_BwLa=VyoC?(tg5rh}o(+2S&=d_@cJ*zC1fxRuvYsf# z|DX2WJF2NI_#gEmipW)p2uPP8O%Rc$w17%)(ow1)B2psKq>Ggv=?DarDj-#QizR@7 z^j@O`3_a3GLc;Gv4RG)G>w0gk_s@Il-G5xibI3lkXJ*fQrtE$4T@y#mMG~lfCLDK9 zP3o}kDDxE>8~{mItbwj5_!$`r`BJ(31xpM_DEldEQZE)09(lSMPjW zDX{0thQWn^i4O1nvtboVhY&uC)kSR;uoC%CsGJ6D1iYoe4b9>0{Q}|?*j|mc zv)`F)({xR5KkpIl{OQ?>tW0sso8}MwbE>y*%8|B_e&TCy@ZGqL@+pzQb4e;71I4~n zxnFti7U}3^fnK^$COO@Nz5W|IDDnc{S`FdxFGYDua`Ii7QYU`o^{&VrP;bA<*(Bd4 z7CkK7d>-R(3%U&LME-cXu+B`l;W?7)h#CBfdQ+^_joB&+yste=I9cpJYKBabCvKrm zO^6t5ZjF1HN7vg87TVZ8b>#*VLv;I&84N7~HOvKID~+z+;79GsvA6vTu?Cjc@-iNI z-*kJXjQ(c>8uZMO6JB~Ao!<6Rkg((#NcI5yERP~g3 z$p774%)CMRHYMVp4E4=CZZz>xL8W3ZF~zZ)BsaH<*^D_0oCPPSg6CEWalp~?5-r@Y3NVSX9e_6AoDKXmoq2uth4RM2@? znpfU;e|;Gq{BmT=8`xTVZRnVgK&4WJ%daH!`M-b^#$k2S{kRa&QDKRo2hGoPjAIt^ z?5|7H+_orW&5z8FKs6=0hdT?z#7xgnu8A2|T{&Qa4V)biji=b~Wj`qedZ7mK`C1rM z!^W+R&s#y;zU(4mlU?%Ui-1j2VEFuNA(uW|&;d4Df)xMEW7WsY9bv#>tp(Eut(j&ZgHgwhWF!$Mk9Xezy$%e$>*8M82S(b}TTIS5hG zxIAN8&c0}FRcn?Rnt|=(f7nhbzx7#wH?O4S14358x61J$wI@!ISsGOQ7dC2hN3Y@1 zBQMiBd?~H5LQk+OHxk?6L!aJ44y6eLWfS5-g&+d!R(n<4jiFX@Sd-|9>3HE z9E^~Hw0Iq#&_LiACiWk!*09owY`)ppo`k{pbNiY!6M>JfV12Kiwo<)SI=Lg(w%KP!Do@@3S*4QhCd3j9B2b`b-3iJJzQC5jfND7kmDYG!v#E z*_+&B2ecnJzWlq--qRq77>t z!MW>P$M71HXmnlCK#@}giBkv>j_FoaRe+%774l!y;tnvf`&{6E!$psVw_ZN@Jr*hJ+qa5X122f0{Rlh1Hp0#;96qB8Y> z@o$r=$VG~yxGuWvg{D6PAX9bij09K2S}_l%S`Tmpb|; z!w`Qx-T)OM!?7dWJW|mRr+I6jqNKuGZduGwOdX1lS8yAVaO`4Y5MLwL#SxY|;7;qt!=4niiHf*eO9zOH<>X{3giKb+5dXO5RJ}B5}m+oH| zK$0}ky1zPe>He#8acj5PY`)~ZMGcllQu%PeD@5Eb-Pa2^N2|&WbbN}^!+~^BY`~=b zaZL4$*VkpOTw7FAgrLXkFg6O>olmr(QX+3h%armX+Hxu7Cq!SX!jJWT0t-Px|ARb}*V zaSZOIPe`HNDQxH*E*gEd3HZDz|-Vkn2~NN9?g!iXonU17m z+B5@lQY#7!?d`_AoW89@9i|cSn!#!y z(&MA%fJeqnRL%Ma$L)T`%H_?;;9m`xm&=;kLX41IUfE)BXaYTYo2v zK5-O2dGU(d*(Uk3o~@Ug&j-K6Rr@`858zgmT9!f0*_Bzjer{hkq6ivNdBaMfRQu;LH~FcL$2 z?^}xWZ$2}8-98n@zXiXy+Kz22&A^;rA8ID`Gs#IwQM#Y_HUh@p5)^I<#4jR0JD(Q~ zp9jvaF)CGZayoKMruf5sjQ?ir7rLED*#-kdv*~%OHCJ!+vVq(r#|6^S6Mi6S6xI9= zdSmom)n8gjzS47*eEvhf)}%G|h@34pd*OFEco#VfgMth{9&d5cc4@A;pAH+*dgn(t zCVlI9pu5_0Lm{ixW)o%)IdtG)W9hZ^!R=8{1Y)A)!I%6j{ma##V<&a^yPE;{A6qT8{p7UBl4eh7q++* zfR@{@wA~e7T#<$^OAjZw5Nu|j+dk>5Af25wsrk&Ku+1=Xo_SFFRE=DsqTk>BXvo$_ z#hfavYe&AN(N^93BIfg?@5Rt2mz&pQzZB~|(vA+GA|B2p9$#DSu4t3>Uy~(mE+Ou0 zEKv=-%Tu7+idz&GbbJXu9uu5ZEdKbj+KsMrjTN_o`oR5n+0M^BI#({cQ23DTbvbLM zzA!_<$t2;x=(r{ZalX8gqE9^F&HnMW!&$L4E4PF<$Ixr1L z%w_;w8dHzN)ZwdJ?(M*QF`IrJMIrJ?uMP*7oeo)KxwTyGy|*6Ajic~b9pXo|M5me%&aMN-1nE=}|f@kh=v|vMbqwU#7I!jZ&|{x>Y3L*IM-4}05{a4JwB;~tTVFTzYsb4Vz5g2=ahUX zE!SeI3(%o4b|)X$Y);tu!xK)BryG0b-dfYa-bb+~y}i3t(31-bP8<&=hUHzf)7|9c z;nB@hC+y{Fqf2x~D-RE6U9{ygoA{FWeLX`7tZ&a{+V1&(UR%dM%$=<)RK2yng{RdmFWkx&~|9~mTb~V1B+^i0);w5q` zVKM}B_5R&l|HF;o!qHcoTA$WcIk6oQPfi~OB;;acW zXtV=Kaei~~DE*zHV=tb=_^DUs7g2R%ypgNNae9#;qM-}Ja?@tcw_18tC&Bnzr8{{$ z47*(Cvlhxb=^|#JS8%?nlm7SZZ1eYqhGz#A7bT_AV|-1iyaK>r%j#gNz+5Z2MaRX} z4-m6)FBR9|3nkZq>c9?DU*voJqluw+1tsgl018nwEG1$MFZp*#J3=RL?UlSuhLt|Z zM_-AlKcX`^P0-E^zmuCXQ0C+GqtuT<+De!X2v>A3H`pdbtk zsTFB)j1y!&7`*gLYi%x9=V-3PHzqfqu1GOnEG!<5L!>$!y8CBF$w?B|H7b z&3kE}--}DD`eE)HWuMj&BNKQeoS(ZyEH$BLPn1U(g}N+lL3vSLE@;>U zAun+$$G*oq7KU&Q1wkdDAPe2;6<>>sk+__iN|Byw`Jd(jke%X75{=(H0h*6K#x(uW?bN(!S3}knr!mx*krk?9QC&=^yx?&*Q1&N68Z1${0`Cju_0R~B# z)GEpJ$y%*KmZLmjsJb*w^GdQ}9*I5kQ(r~@H+>yd6c-m?r!t`O!uh!4(1R*0YQy7M-lFuyG>N&SO#j+Ci7Wp*sQ z@k{NylZM`0K{;Gb9;o88i>-9#{Pb$x`&9F;q}yY8`UpohC>j_>2h)s^1+ zDa|q>V%jp1u3G6%q-ne7V-6nGY9ti3ev_>?|IhmC6>}l?+GhLh|Q8MpV zZ3J`a2XP#mzI=fJ`pw>NV?u9^G$bcaEyi={nthoB*7>iwvS_Fem4}c_vt``cUy4p!(*YNPIH3d>UW;>gQaP>{FzI?%*iC&drZC(!j5m4iMN2xgG_`;P%Dw%3V7k zpa~dPyYhrPyQ3bVyLcq%<;$12Sx>a5d(*E~NJZZi4NhvVni3WL@s!594AbllNK2@= zi+f6Um&S%#(jJSAP}IFb6+A`(drQ!-T|WERK7BY2uFPtg50z6 z&CJO)3o;9W8mZNsgge>|_Gt|xP@T55ecb_wsZF*e=i9|bnPVkdSN{GM)l843>YZ4w zi}( zkr;Gu0}~oBEJDC{skn<@0A7WO;eHx0YTH>r^;U2`vcNdx85!`9RPWi%Lq*j? zfDf1fW&<1h5R2@D=7gMwdL>OJ8445R^hc*Rd&<=tXKQz<4`Y5YWLgIRlwFTNC!l8C z#mc7l)K#W#wG>!IGBdx7q<7h&mzxX?4Mt2q@|=H4Qn8OJ^bCJdz!+W(%^14n3zPY?JDFb>0%oMQ zRHn`BdkYyWk*HS80dR>-|Co>_*%0n6=%065nO+PD)Do`h{^7aI8Sawq-0#NM_q1Y{ zKctIm6%P?A!;Abre|X*{2u{jcXbz%p^qt2T=N z*UZVYj1}Q7(euQIr2gT#yN04ohCzEl=|9NcK+hY9fc@<`x7)gM}mgA<^6I0LQG@;#&`~Zh7S%N zC51QtdjHQm?&<*Y(kv(_{NEk|=nWtsB;q66wXHur*94H4#a(BQKS9H%05oKrc=+*8 z(9nW}?)4q>&;IZ9(FvFX1pYY8sPKp9GtmGvOt@iY@h5SA0|T@ltlu=xjrK%;uUe&f^gC&!`J&HEHx73uaP77CChGEbBO%A7>U97l1rmty*0#qAbT*5ZSa=cE*JY*B zijB}40nv6?2(RSa2C{r-9Sujzx2?b$>)bn2<-@$ci2pV&K}JB_UXqt=GQH13u<-s^ zRE3*axDHRRx^#Y7D!kp$P>ZWA+HqcQgX7NjdyiI{I1apZXjRq+ol!~(D|oDS7qMF6 zJnH8c(-*voUuwt+g@l*N;|f&gN^9-Y;)hrcIYrsoWU8!R*0+r+GOcKqa!L$qS0P)m zE)Zb9K7D(#=OBX49YLr?$mK?jHv~$*~zFz$9DSD|1~c$gM-6R)hM9Rp2MK_(j<;?-F{pFum2kf0^v!5x{^M`_kld?K9!4luK2s z9p6XlB>(;%FFsW31@Tx+GdE~d3z=Et^r$6OKRd@B*cxm<=4!~aFH;>0_8Q67v|b!3 zH<0DwJ7b=$sU<;XW6M!BC#?bG;64kV_)t-cDy|}cMqE|Z>unmnquo^RwJdwwqAjD^ zjUShmtnSZJ`DVY;=zKds&ldH!&q^+4uzzeTTHAj<_3shVst7f;XbhCS&U6$K3Gek{AZe2`Yg`_sKFv5EWin7cTIfc2&*s6WkwE4KTPlW znLhUmAG$as5^+34Qqd+>jrYhi=h+ghiToFNnk$tZXiX@Jbr-N3pVndKTdk!(&( z_)xk59LeO85I9rXpdKN>74mGR%IXVKOZ?fQEmPh49$%iqDrtd2!@_zfy0DgrtI?@8 z5%QXzHu>@{!Z(VA`uUm`OXRy_tR?g%nYRq^{#3Su0SRuujlz40qd*ljqJW2QpOuI= z`id}t=gl%k>R?Gt0r^{w*moUr?|>w1EVqKkr(^ONCp$(P{AX-6#cXT`ZFM*NP~Tv+ z&mzMgtmpDei&eBWc{el)yzrw`B5ex*zz^ zmz6jLkIXu))u8NAo(XISblY`x!Z{gQ)FHR&+^-28GE|mZ)^f^4H6Yz@wm-+SBaTFu zDVvvYZ{2*(VXVt>GUFmocg&zzTm%7{I-HQU!JgANg@P@!h339n(K{WuIxV{Swx3=- zLxO>qfwknjM)+}!bzSP$G@{$%cUR*R`aR{jQerIwcS1DBr&5vBtdP<}(6Jt6R}u}Fk+LwP3`VE}|(Or>WRTQnN6 z$I>NX4fiJc3=MeaFKqC+iMh~eIjXvoxy55yB zTRfrqh~HU^V5D*3s<8Lp-G^Jw#p&WVf+JWWq8Sug&ecnAaKUjWX1nLyDknzRWyt{h zEg#@m`umdRE|U!^kgWeq(H#`f-)~~neJKSJ^(Hv#NYvLmx}&iPVW_piE$ljrGhJX5 z_>LxQ>G2ZuzPwCR#$yGUVcRra+I|dn=7&zm3(rZOGq-sz(VK0T2U=p}mZKO1T)`1i z!S=X_H^DkPx7aY@lA=BF*%hIyEY4jMJoHhMA--N?-uAVhyH;c6?gmQBOMG!03XU)p z2V{+nk3Q;JFkS(b_vG%5DjKD?13jDSb&07;s{m#Q90h%&rho9<1Y7UxMyZARc1?D& z13t)M1i?L42PX_d;Plz zu7#Dd!_VcDv!hy1Fk{t%6Q7-R#;QH;yTl3mA$a=7lmSv#*>`T--0vHA_Ir)dP591Z z_aQB%lP&RbVqJ`hvcV3qJ@L>d!IUj^fk>?9NzkdD_(17_-l`Q^g&T`0XT@8koDfZ~ zd<7l)0s>QGXEtRuLSEd2hX6COPaWy?yS+(kkGqk1p?g4zyuR-;7B@BBbu#kUS6j3e z4pO5-z)3D_#I;wueNDexjGgAO>WXa_6NtuUt$BG=O1e`Ug*z-3VaN)j4+%>=Hy1>; z^SaR3{Ywr#r5FQ>Si6aYc5L-sYQR1zIHr`E`B@f|Od-n7?$M{2tch0@t*hYIlX!b2 z5ct|g`#ZtE=s-7l^tvHoGKiVDp>&sb?|hR4lhbu%(M+3>7sTdlx^S$^3&r$opOzZm zEiR%1iE-M0FRn}TT#9j8y{d)ha7NyupFVuO4EZhPw_7P5A$2!6i{vTn1ujQ~Z*XTT z%IwHvX0LPc$TU)Ei=51m=#kJ`Ua0Mmuf%#b99DKK@i;$IpKCg|#TkD<&5n5_$00M_ zJc&n;fu#iIH|IF#KWDAmt2Ip%)@(CO06t_Vy;duSxl#K#z%ppyse}wKoPDroCb$fW zcO8=o^$f{vT8WbQcFN#sqlE3_1*(YFV9ejO%$uWTTHv_J@LMK+n-jjAZ)}z^a)Pd{ zq8u#4JprmfwJ-oYA-`aiG$$0eTT}jD!)H_dpfZK4b6*1i_lzzmpyQH*;5Sk+O=>|! ze#EeKtI5F(%I`!Wczwmk8W5V{ui6c;)J(mrH0D83+AOwbi(gQX4u*H|$u)$tT&FV= zzCe7*wh5Qb_G}#-{G3xiC(U5HV^F`-uIia78+Aa#OaaGjp^5iPdMoD;rDB(P|I>z8 zyAf|*I?TqWxNOEV+&qL{n4seFH(Q+8!o;hKHr+pB5y6;jJ#jsSXoixl2QEDUoyAYO zE;21{%8&!#SYc~~N=pI1=RP09bcPPLK^TzxY$c^};WhHjqr^D@XK8caD>6s7c}zxptKPx%R6#gRblPALd_ zw;?{7xBck?cf^qpO+jylW(USAh$#N^la?bZhd!-36!#EZH@bDi9)Sk*)y-1N)CX7!B_f6eKo%K9&bGI zC^6|xz4GL=xOBsLcblc#4KF-}*z9aHGKQcv)4l41e(gXDFjL8Q>Ldvd1Ku+{#GxKW zqxF`tK$|BYie*%)gU>Tx5M>=3u#BvKf$dg@3wU}OF%OZ zRV34hvj3EpC0^b&m7mk5PmR~araqoUnE@Vi6C~M#A5kw5x5PWn8lMb#=XXoj?bBbs zQLA+vkjZ$va@bgY-$Z>5DR|8nv_IW)#GT#wn&Gi>T4oY7OCJ*426q1{iZ@UVThyyse?2~#9osZGSbh+a z#(zh@=e0a5PlSN_CQ4pR*~nLRb*xe{Aw81b3qjAZ81=Sgo-X6W$|A72&Pl}?;gx>u zqeAMj=VM@%OJ(zE@O*#vMV3X@ko-Gsw@%=7$M0EFYRg`anGpXe(9TCT49W%I&v{16-b?)7$I; zL*{*)U}6l0r$FJ4bU_s9w(=N6rxl(0(+wF`EJ3Nco1P2S>Co343GBz&(E!Imy_y(x z9IjqPL{F;Q*>D+1S^V&2{+=+0^3%gq(V+VX;&tUIF`MAzi zO=2nnsI_eUNFqbI}8xdf(5X@$M(tiAO0vexUkiZ`m3 z3GVW9vCtItLEAKb(8@f`xMM=Zs^5nVB?Y~60cXV+Kxa~UuqVa%lGU~mYS6OAVCc}~ z=1IFAcazzGk!JVXB}-xChJ*jr$o_ru^PrhpuV6V>u+B6KU|w3V655ORKXt4=Q5*kD zeluasAt!R|mA#*P%Z(~P;G$p%)KCpJo2xZvsEfuX9iP21 z()=#L+|xlE$77+34^WSA7i~Dv5~1WwN6bA4mKSd&hWF~`7uMkNf-n)7MlXDI6aINb zD~o55l~Z?zgS#>uKYL?afk!D;_v{9)vQBV(N&RY8*fRcThSDft`Mq3@7WEz;_k{iS z9oNdQi3gE z@x9_P!O~C=M>C^ZEvIj(f`u0%EV-L%mRRh+0_|p4c6$4?#L)T0c z0@W|ByHj;edJe-M_?+BwsOSJhS6StW5B5cV+~@h}I7T%4v9#{qloQ?^vh&Q%pF@=l z?kZ27(f)KYLw!XsC!SvjLe5vliUKV6(As6q=CyAU0A25us1a|%%{<43gy~Y@!VIitR^H|w6B~;I znk_fk$--u$16n)|e0JWqn1NyL6;t?bE)@j)SkqeHZb0Wnhz=W08yImc)b3_uW|Dx+ z=HLx;|NZRW*CC+zfr5!vv}*Z@&Muw*yr|&=Tt_*RiPb+}y*tD;U{)$0BKY0^@VrYB zz}|)BRk%N;P9Kp{r!I1@$y5C&dkzE@lCtOj=#SY8(@An<6b7>A_fXX2rLs%e?+bUJ z%`C%Fq_ANh>LNpD(z{++0|Y)|)1CR#b4OD4+|hNNtd0ABOybocQuci8!DTXd`1f;* z6F~O-Mp*uC@6bQ#rxP#*2>jY~LS~;M{ zif-TbGD#kQysfY*t{?H-rnWOy>H9sYAUoiFrnjw&_A$&FcW9{|9W)my>YqDOJ^zhw zh!j%;dAf4kx^&&^8?~O!ZsQ-^k1lL?ROZ8RUkdtbK+=Yta^*QLwO)0E#Ve2Nfqky? zr9kM7PVwJBjNl?=F?lhp^s2nl#JOyEVFe)yq4HpetX$53%qxP)IR%nHWI*S|#SQ!y zKqgWgt=^5G7Wy4vvl#rE#r@$d(n{um*S|p}-kw>ZwJ-+bKhRp~I|G?eJ}F~dhFE?PvM8Mdn-eG~&j zKdz9&RFX2rP(<}rZKa3#Mzg}V^Wpl0CbJ3iMuqHy8l!OuR(g$wN>sIkud^?4zRS#5 z-+)^pPam&;NkigyJkdGp%RqhtS?4(W(ZXvSc09+1E9BkQVk72UKp;eZ{%vlsCLLJ> z4vgn*Y+22ewe~5RaK0k1AdrI`Nf*bKLM;_AMe8K|mru&^d3<{cujQS0k%MEZ*VOT6 zm`w5FR1A9EsZnycRy5qSp6F4uh|juR)-*P5*Z}!(vW~^TUPQuw;OH|HxpOcm_vDMA z#F1=zmVNrucIHKqJsmRG;We%xgB~_%pAs6K2*4?A)=#(R%a4=PfLUvN7m#oxore&I>(=InL`*nJb za#9rA>)DdUl`^;tTWSnwPm;tsxUqAzRgOQjl+De-b17~-4U|S@c?_`+0&0p(_ z82O?iUDkGn3=WLsoeHL5aoDqT^BAVf6A2jsWR5lW?51(I!UUm;TUqvVqIwVH>LQW_AY<$Y%Te7vGN zcMjzhcVmbw@kvQ4^rH#!gKEB-7J{OmP+@vcF8XhWWY~DGpST5E1sqtP}k@A~bTvu@HL;xs@KUF2n0~`*B5axYt$l7RlDstvM4Twm~jE zFw-^2%b|ZW}!v zcNd7xfFeu8qb_GvZ!=kU=!Tc6YV+1SawU5%^F-ilnYFGf`7@cifgiYFU*N=N(tW*` zV6M2?elhUoichBEoFNom2z4wekezI7&jC3^wN8Qf(%*px4uwQ+J@Bd%*Dhg%4GXp~ zbk^+vL6g@8x)VWVbM?csPlLul61)hW5Y0M^64Uq^Yb8_dvs8`FBh^k$sQOhRS$Sux zXPlrSD&{G`0SiW2)h7)=gn?oB^~E}yz!h}lD10DXN3FAwNUWt5{y~_t8cVy?Ix5gA zSLZhPC_`#RQfl&LY}t__7%jMuw|FITr=SQp*$|5(I^<8j++c!3Z-ziUvD@2_hVAK8 z`wWXouXpyHsZEjrz;}jHLT{NiWYJ&1mcOw@uuvxki#Lef(T>`_L~i*H>H$!||5O)T z8}Y%N@hG+?AE}d(vjIGU-Kji+GI3nK3*Ff$8IRAZ6g)(EVm&6)qz}Y8GH-==^Gsrn zMO0)P5)}Of#bZ}B`;FcOPJc>r} zH2vmCuRvq1wA0YF<`b~*q?A0?G8O_UdG9j{Qu&lgd4<;hMEiyVY8HSCJ?7hnJM`2cmX-D8jdKZ z5dT^otn6f!mATjrK4-xVHM-2J8m1g@XE&i9FZd9>{Bo(B15?QBx+O6UTT}fE4lN)s z5D7R~?X`u#AC4e?PV*qABu$S2P0nwh85>gVLy0O(pLZA(bnl06KQjK1xHL=3*Ky|3 zw>41SL7k9z-*L$EJVr6c+ZNQ_ok$zRbFvJ&>;TYkuCk$K z&!o+~Qfy$lB5%<(%KW^Tlq?|5iC0R&h+)2(7z1xrT%3vD+s*GU-bpO#yU(EK)e#^u zWxWv_kr!ptuxTtS7ZASYtX~DRupxN1U}O|XeV2(!qP-uTX5fvw6LR(Hg26}Lh|3O~ zHxNn_g|o{hX+HN?BOnS7AaT)`UBLqa*YC(CN=n&WZA2k`-D3JeAj)_|tp2j-fcU8j zPL)*mHdN#$%S-yBzfIPwHWHL|@%PyCQe8?xbtk~Oyx~{qTOP|T(}DPG=$A93xeP=* z{FjxPp{q3wb|~1V3csXGKf|ktI3_-5$F^TmUVwVYO(e^@r7)9%)BN?TelD+9XSzCb zKFXlV;Zh6B%E+)NdI#swDLT=xDE6E58P3m~!wCMFUQKJ)N|@S2WL;9E)A=Stry5@g z=B{*0&iZfcA`v`b3bq-@NDa6>6RW6DueW{3-`xe;`;BW}VhY%_kUmP|5f2UJaMTR1 zX|(#GdI6-3jop~V&U}U{H?E2>9o97y7P55Kwy($g(J#me#wM^z*??N7!-AXF45EgD zGc}!}-nWcqHeCE3xH4O@qH23fE&Omx467?x<$ic6$Cu!UH6lwj{f^Detx=b{tW!!1 zn;9@0j+kJ#A>*RKl6l1t*T8pFsqRj?GueYMtr{Z>gaj(sY?m4py-HYt{6>v$}&&Vbu9G8Fr19XYTdrr?#nA$5+r z6nf5WuBh3+!S2+*hBklWOXhI%(4n5)U%h!*K{zVwF0O-*iFS^|}i4 zDge%z*~exOwHi8YaAEx3;<0vV^hqa+2S13A0TY|GD_YL(MBfPmuk>cu@c29YlIcH4 zC8qBpQMYEKdw8wVKn!OH6DLHk1G9?_nJw+9KxHTQe0yJhj_3O7a5AJ&RYv0JbM`ee zTTp0DH_vSMo8~u;hJBzjJ&)b+!Te`xNaaMnOED)Mj$=sS#3T*Uq)`DGDKnRaoqdn; zi-;II#~HkVYc+vDQX>+1Dzj4o=A>cJ5$}#gFntb9vPjOI=my`F1vK$L1u>{boE)Te5GpyE>-MKsGf(@)8LH z_FZ;O$<_&lsOZ}PwcPm*>;se7T2zN@KB*M|x7D9^hvAsR=^qdHWO_gjVgl4rHlg@x zrMEQq0oZK@#xK0BHI=Bq6@{RPNyNy({* zn7PzeF2J(OEDWR7i;LSvg^o5sqyw&qSs34VB43yWpem7Bf%FGCWMg>V8Bmg6J6Lw} z1=h-xHn8VI`u9OH&%G>H?;#=0u{ybayvOwIJ>Bm>-(A}(F@w%~OLg9GmDi|Ct+;64_=N9N%-V$cwTy)4RFHY^r;I@?{tEZlvo6I1(2hcVO9fs122 z>Qyir=e)eIv9n=?AJ60Tom~Fz!z(>$@wj4Zo*=FRE~thv@U=fxpz5aPgiVs_<*9;& zAGs$6Az?m<$r*x*(b`#fSNTTSH6SeVL8^|lJm2ufzrM#&)}#^}F{N|^A={e0*mZ?g z`}x654}JTN)7w2v=b~bRJzGb8K7DhX=UFabvAgi*80zKu&Onpd@lP9i3aM@Im#sNo z*$C4bm)*{r2ntbL%UA{L*=(JC){Bk>SO8$$hhFiYnY|l8;&A?H>8j3;08Hp?jy~3v znO?WE>CW>64sSywd<+VdP=5qN{yyt9&E;2?8Yv)C3EujqnI{h(F_Q-ZN13TaKB0j_ zEjvBnXi0*KVrJsxhs0>dTn5(aaoJ99dw+_Qoi$~Gks@~6`c5Lp3ymO+}jW-g)e*N+YbixWZyHr4-I|szUkl%^vlLo6Er7 zz~7mg^QVAhx>nP;$^HyWF)szJ+!k%SucZ$n`+Jo?-Mo0FNP%=zhlvfBdT6X^NH;6i z@W$f?u!cSgh~&n^S?#)NYux?2f>X|&dh@%LvbcuScjJZ6X>XR03||+w zAwd25RCpO(>K7}rSHaOo3E8jjT9!Vc0-`xmrd|qwtK(jq^6kl1JMq#Y!)oC``A-7l zv6}?zItJ{D_sD?tNAG2wf{cV;3=DnFXQ2)sT2U^lbXI7n`MP;-p*B^OxS-F0^zA&@ zFFEK}iuQ;}I-Jjcgnw5hlu4DLAnT_a=1$lL6cMFmWk(I}qrDm|2;WAD6}S8YHmzCZJ6KN z<`C4+3+zU}dso|IKRVO#@%L~NmYos8HYd75g*{VDejB2^ok<8Y`{NT0$$IO)_$KW zbXVk#7z)l)*x7~)*EEUw_tBdyP-OfDT=p zdJzbujd>*s6)>*{`t){8>#-uW`JVzef`c&lp142@!n8Kn0=ctxr6_;Xs&;8(Zr+Py zpzdsT6Yl*fS}9EMD!9%Ls~Ri8<-X_bfrDCvITfal@yhK{KpAgoy%QWkz;JjWRAh7M zL!OuUe_LhC=NKgL!XoQ*X%dUTi<<2@S-tan>e(X>s%$$%A<7wo(v^_C)CsKLQy>_Xc zi!cJ*((9F0z&JT;K(bq!AYe80T=bzK4-4EoM4d^`R#MRzxTU+J&k>-(3(~*LvzR}Z zrOM7yK;N(FcoVUFwt|yQcK7HM;74bHnr_L*uX_i-05EgvP)~3~@DzHYu3TLo!O99W z*w3Es;E5O})R*86BEtB%ZsV1PpYO^%VHPG3#%C%Dv znBr@;ou9X}{C+l0QsM5=ojrqf?PX{ybdQV!K^@dny$TU#SS#6`@_ziz%4ct=@?}so zC)(;AnEFD|`yCJcAGie~rTkY<$tvGN6wA6Ll|!ez5J0^{;V4>4C|Dxy?eG5_N6l&L*gqJt|8XN= zg&BJdDgM;=0R*qxhyRBZ$ri;1c>JHZ|0NKBTmOlBzmEOVmj71wAB@9)tNUN}5HME% z8T0?SfPUWj&zS#DYx|$?{+|oz=biue`tG0|+Sov*8;4j~fp+Bs2h^2yt`=Ule)N9; Dg$y%% literal 0 HcmV?d00001 diff --git a/docs/code-snippets/disabling_marketplace_suggestions_programmatically.md b/docs/code-snippets/disabling_marketplace_suggestions_programmatically.md index 30e6d358222..3780f13fdef 100644 --- a/docs/code-snippets/disabling_marketplace_suggestions_programmatically.md +++ b/docs/code-snippets/disabling_marketplace_suggestions_programmatically.md @@ -4,10 +4,13 @@ menu_title: Disabling marketplace suggestions current wccom url: https://woocommerce.com/document/woocommerce-marketplace-suggestions-settings/#section-6 --- -## Disabling Marketplace Suggestions Programmatically For those who prefer to programmatically disable marketplace suggestions that are fetched from woocommerce.com, add the `woocommerce_allow_marketplace_suggestions` filter to your theme’s `functions.php` or a custom plugin. For example: +```php +add_filter( 'woocommerce_allow_marketplace_suggestions', '__return_false' ); +``` + This filter will completely remove Marketplace Suggestions from your WooCommerce admin. diff --git a/docs/code-snippets/free_shipping_customization.md b/docs/code-snippets/free_shipping_customization.md index 6d4d700a39f..6c8372c5827 100644 --- a/docs/code-snippets/free_shipping_customization.md +++ b/docs/code-snippets/free_shipping_customization.md @@ -18,7 +18,7 @@ The functionality to hide all other methods, and only show Free Shipping, requir Before adding snippets, clear your WooCommerce cache. Go to WooCommerce > System Status > Tools > WooCommerce Transients > Clear transients. -Add this code to your child theme’s `functions.php`, or via a plugin that allows custom functions to be added. Please don’t add custom code directly to a parent theme’s `functions.php` as changes are entirely erased when a parent theme updates. +Add this code to your child theme's `functions.php`, or via a plugin that allows custom functions to be added. Please don't add custom code directly to a parent theme's `functions.php` as changes are entirely erased when a parent theme updates. ## Code Snippets @@ -34,7 +34,7 @@ This means you can use `add_filter()` on `woocommerce_shipping_free_shipping_is_ ### How do I only show Free Shipping? -The following snippet hides everything but `free_shipping`, if it’s available and the customer's cart qualifies. +The following snippet hides everything but `free_shipping`, if it's available and the customer's cart qualifies. ```php /** @@ -59,7 +59,7 @@ add_filter( 'woocommerce_package_rates', 'my_hide_shipping_when_free_is_availabl ### How do I only show Local Pickup and Free Shipping? -The snippet below hides everything but `free_shipping` and `local_pickup`, if it’s available and the customer's cart qualifies. +The snippet below hides everything but `free_shipping` and `local_pickup`, if it's available and the customer's cart qualifies. ```php diff --git a/docs/code-snippets/legacy_local_pickup_advacned_settings_and_customization.md b/docs/code-snippets/legacy_local_pickup_advacned_settings_and_customization.md index d05a8c7e788..3d54d26147f 100644 --- a/docs/code-snippets/legacy_local_pickup_advacned_settings_and_customization.md +++ b/docs/code-snippets/legacy_local_pickup_advacned_settings_and_customization.md @@ -1,15 +1,13 @@ --- -post_title: Legacy Local Pickup Advanced Settings and Customization +post_title: Advanced settings and customization for legacy Local Pickup tags: code-snippet current wccom url: https://woocommerce.com/document/local-pickup/#advanced-settings-customization note: Docs links out to Skyverge's site for howto add a custom email - do we have our own alternative? --- -# Advanced settings and customization for legacy Local Pickup - ## Disable local taxes when using local pickup -Local Pickup calculates taxes based on your store’s location (address) by default, and not the customer’s address. Add this snippet at the end of your theme's `functions.php` to use your standard tax configuration instead: +Local Pickup calculates taxes based on your store's location (address) by default, and not the customer's address. Add this snippet at the end of your theme's `functions.php` to use your standard tax configuration instead: ```php add_filter( 'woocommerce_apply_base_tax_for_local_pickup', '__return_false' ); @@ -19,7 +17,7 @@ Regular taxes is then used when local pickup is selected, instead of store-locat ## Changing the location for local taxes -To charge local taxes based on the postcode and city of the local pickup location, you need to define the shop’s base city and post code using this example code: +To charge local taxes based on the postcode and city of the local pickup location, you need to define the shop's base city and post code using this example code: ```php add_filter( 'woocommerce_countries_base_postcode', create_function( '', 'return "80903";' ) ); @@ -33,5 +31,5 @@ Update `80903` to reflect your preferred postcode/zip, and `COLORADO SPRINGS` wi _Shipping Address_ is not displayed on the admin order emails when Local Pickup is used as the shipping method. Since all core shipping options use the standard order flow, customers receive the same order confirmation email whether they select local pickup or any other shipping option. -Use this guide to create custom emails for local pickup if you’d like to send a separate email for local pickup orders: [How to Add a Custom WooCommerce Email](https://www.skyverge.com/blog/how-to-add-a-custom-woocommerce-email/). +Use this guide to create custom emails for local pickup if you'd like to send a separate email for local pickup orders: [How to Add a Custom WooCommerce Email](https://www.skyverge.com/blog/how-to-add-a-custom-woocommerce-email/). diff --git a/docs/code-snippets/making_translations_upgrade_safe.md b/docs/code-snippets/making_translations_upgrade_safe.md index 2753c1f43bf..fa1cebd26bd 100644 --- a/docs/code-snippets/making_translations_upgrade_safe.md +++ b/docs/code-snippets/making_translations_upgrade_safe.md @@ -5,8 +5,6 @@ tags: code-snippet current wccom url: https://woocommerce.com/document/woocommerce-localization/#making-your-translation-upgrade-safe --- -# Making your translation upgrade safe - Like all other plugins, WooCommerce keeps translations in `wp-content/languages/plugins`. However, if you want to include a custom translation, you can add them to `wp-content/languages/woocommerce`, or you can use a snippet to load a custom translation stored elsewhere: diff --git a/docs/code-snippets/ssl_and_https_and_woocommerce_websites_behind_load_balanacers_or_reverse_proxies.md b/docs/code-snippets/ssl_and_https_and_woocommerce_websites_behind_load_balanacers_or_reverse_proxies.md index 8f6d733bec3..02eab4cef6c 100644 --- a/docs/code-snippets/ssl_and_https_and_woocommerce_websites_behind_load_balanacers_or_reverse_proxies.md +++ b/docs/code-snippets/ssl_and_https_and_woocommerce_websites_behind_load_balanacers_or_reverse_proxies.md @@ -9,7 +9,7 @@ current wccom url: https://woocommerce.com/document/ssl-and-https/#websites-behi WooCommerce uses the `is_ssl()` WordPress function to verify if your website using SSL or not. -`is_ssl()` checks if the connection is via HTTPS or on Port 443. However, this won’t work for websites behind load balancers, especially websites hosted at Network Solutions. For details, read [WordPress is_ssl() function reference notes](https://codex.wordpress.org/Function_Reference/is_ssl#Notes). +`is_ssl()` checks if the connection is via HTTPS or on Port 443. However, this won't work for websites behind load balancers, especially websites hosted at Network Solutions. For details, read [WordPress is_ssl() function reference notes](https://codex.wordpress.org/Function_Reference/is_ssl#Notes). Websites behind load balancers or reverse proxies that support `HTTP_X_FORWARDED_PROTO` can be fixed by adding the following code to the `wp-config.php` file, above the require_once call: diff --git a/docs/code-snippets/uninstall_remove_all_woocommerce_data.md b/docs/code-snippets/uninstall_remove_all_woocommerce_data.md index be83e2bca03..1d216d4793c 100644 --- a/docs/code-snippets/uninstall_remove_all_woocommerce_data.md +++ b/docs/code-snippets/uninstall_remove_all_woocommerce_data.md @@ -5,20 +5,18 @@ tags: code-snippet current wccom url: https://woocommerce.com/document/installing-uninstalling-woocommerce/#uninstalling-woocommerce --- -# Uninstall and remove all WooCommerce Data - The WooCommerce plugin can be uninstalled like any other WordPress plugin. By default, the WooCommerce data is left in place though. -If you need to remove *all* WooCommerce data as well, including products, order data, coupons, etc., you need to to modify the site’s `wp-config.php` *before* deactivating and deleting the WooCommerce plugin. +If you need to remove *all* WooCommerce data as well, including products, order data, coupons, etc., you need to to modify the site's `wp-config.php` *before* deactivating and deleting the WooCommerce plugin. As this action is destructive and permanent, the information is provided as is. WooCommerce Support cannot help with this process or anything that happens as a result. -To fully remove all WooCommerce data from your WordPress site, open `wp-config.php`, scroll down to the bottom of the file, and add the following constant on its own line above `/* That’s all, stop editing. */`. +To fully remove all WooCommerce data from your WordPress site, open `wp-config.php`, scroll down to the bottom of the file, and add the following constant on its own line above `/* That's all, stop editing. */`. ```php define( 'WC_REMOVE_ALL_DATA', true ); -/* That’s all, stop editing! Happy publishing. */ +/* That's all, stop editing! Happy publishing. */ ``` Then, once the changes are saved to the file, when you deactivate and delete WooCommerce, all of its data is removed from your WordPress site database. diff --git a/docs/code-snippets/using_nginx_server_to_protect_your_uploads_directory.md b/docs/code-snippets/using_nginx_server_to_protect_your_uploads_directory.md index 3f3171a90e5..64d9ec72664 100644 --- a/docs/code-snippets/using_nginx_server_to_protect_your_uploads_directory.md +++ b/docs/code-snippets/using_nginx_server_to_protect_your_uploads_directory.md @@ -5,8 +5,6 @@ tags: code-snippet current wccom url: https://woocommerce.com/document/digital-downloadable-product-handling/#protecting-your-uploads-directory --- -## Using NGINX server to protect your upload directory - If you using NGINX server for your site along with **X-Accel-Redirect/X-Sendfile** or **Force Downloads** download method, it is necessary that you add this configuration for better security: ```php diff --git a/docs/docs-manifest.json b/docs/docs-manifest.json index 81c4c82c3c2..00c65ffeb77 100644 --- a/docs/docs-manifest.json +++ b/docs/docs-manifest.json @@ -23,7 +23,7 @@ "menu_title": "Theming for Woo Blocks", "tags": "reference", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/block-theme-development/theming-woo-blocks.md", - "hash": "4e0614ad8cb28735cfc8a3e3331c28386d1ceeadb1d1ce8fe529f2846e06b631", + "hash": "1ce763e8afcc7dfdd8c5eca4da799add21dfac48279c08fc7b614071edb67a7d", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/block-theme-development/theming-woo-blocks.md", "id": "90b16f4143d6db728d5ed6dce2ee2c60bdcfdbf6" }, @@ -32,7 +32,7 @@ "menu_title": "CSS Styling for Themes", "tags": "reference", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/block-theme-development/css-styling.md", - "hash": "422b2e0008ad1809a50c61851abe5c43c6f6743f216bcd9ba7dc5251f65e749d", + "hash": "fe209b833c972e17a30b5b17d079f97c9d9ddfa5e8d6af2127ed4d87c469cd06", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/block-theme-development/css-styling.md", "id": "55b3452119141753ee1eaeee5f8d471ab362945b" }, @@ -41,7 +41,7 @@ "menu_title": "Cart and Checkout Blocks Theming", "tags": "reference", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/block-theme-development/cart-and-checkout.md", - "hash": "bb65130caa017d16d84226d0383d5441113ebb1c4a7e5f05c52a6ebf56514aa3", + "hash": "79e8ab04829f423d8cfd749e189dc97586992314d70abe8f7efd10c66b93a44a", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/block-theme-development/cart-and-checkout.md", "id": "8ff3a904e51ef1a07a0a6b0c77b0134a2cb0a8e5" } @@ -66,7 +66,7 @@ "menu_title": "Configure caching plugins", "tags": "how-to", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/building-a-woo-store/configuring-caching-plugins.md", - "hash": "5f0d999813ace7d5a9b2ae830d67b50c05806d87d1ba1cbb2d2c88a69aec1328", + "hash": "7efe019f643f79cd143a7c555b40d61d3a7c91d1d28db43888ea12c1fdd71dc8", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/building-a-woo-store/configuring-caching-plugins.md", "id": "9f484f8db1111fa6c1b6108d40939c967eea7f47" }, @@ -198,7 +198,7 @@ "menu_title": "Inner Block Types", "tags": "reference", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/cart-and-checkout-blocks/available-filters/additional-cart-checkout-inner-block-types.md", - "hash": "10534fe4d38115dd95efb4d791593c3b32db0317239b49ca8101ad744c22fd32", + "hash": "7f8f59cf376c801b6c2870af356fac28f403c890d1652039f302e244159ee7db", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/cart-and-checkout-blocks/available-filters/additional-cart-checkout-inner-block-types.md", "id": "3167c9602b1bd3b206226a0d4415944a5f647495" } @@ -278,7 +278,7 @@ "menu_title": "NGINX server to protect upload directory", "tags": "code-snippet", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/code-snippets/using_nginx_server_to_protect_your_uploads_directory.md", - "hash": "5d7afe5c8217c3a5f753eb2f468b8304f7f9b5b1275461abf2146e4de82ed6b2", + "hash": "5039ec5e7804fba4095faabc5404d7d62a74fb059696e3f6359fd42e20803014", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/code-snippets/using_nginx_server_to_protect_your_uploads_directory.md", "id": "8b325d3483f9a8d09961ca1082839752137faebf" }, @@ -295,7 +295,7 @@ "menu_title": "Uninstalling and removing data", "tags": "code-snippet", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/code-snippets/uninstall_remove_all_woocommerce_data.md", - "hash": "73483ff158ceac81685a9cd52335dc98e99ac7f84d89cdbcf4ce994e18afe30d", + "hash": "9bb8da9a3fba1397c0309280bbd69fecac2215a3ff0205869ce363cf8eb47849", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/code-snippets/uninstall_remove_all_woocommerce_data.md", "id": "36b571fcf2471737729ab4769e2c721b2248187f" }, @@ -312,7 +312,7 @@ "menu_title": "SSL and HTTPS and WooCommerce", "tags": "code-snippet", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/code-snippets/ssl_and_https_and_woocommerce_websites_behind_load_balanacers_or_reverse_proxies.md", - "hash": "92a5091c27d1af6c0b49df143dd13886fb2cb30538fa877f68000cab69f4f502", + "hash": "a3e5c103b7c929fd7914d872956eb8075a25aade50754f00ca5def0b99cdcd90", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/code-snippets/ssl_and_https_and_woocommerce_websites_behind_load_balanacers_or_reverse_proxies.md", "id": "78d5b5a20ce6471b74f809386eff41fffe2d1adb" }, @@ -346,7 +346,7 @@ "menu_title": "Translation upgrade safety", "tags": "code-snippet", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/code-snippets/making_translations_upgrade_safe.md", - "hash": "e2d296630d7af888a072de51870f3b4ff311b3c29f706fda735bd8f9122c8710", + "hash": "ad688decb538ac2b0cf32cbdb60b347e203dfa4c2c17bd687e839cb65e54f72d", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/code-snippets/making_translations_upgrade_safe.md", "id": "0c1add87ef9f5452b4c8404bb55021ad8265c171" }, @@ -360,10 +360,10 @@ "id": "34da337f79be5ce857024f541a99d302174ca37d" }, { - "post_title": "Legacy Local Pickup Advanced Settings and Customization", + "post_title": "Advanced settings and customization for legacy Local Pickup", "tags": "code-snippet", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/code-snippets/legacy_local_pickup_advacned_settings_and_customization.md", - "hash": "d0269f1ee2700356672a032e4e54491666b901765045f7c5224ef07eeb9d9598", + "hash": "dad4a05008807f4d16d5f3b283354889114db7394817e2e6468c8ff34f0ed6d2", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/code-snippets/legacy_local_pickup_advacned_settings_and_customization.md", "id": "c4d4a2276fc251082a80a8330eea1eb62a97c3bb" }, @@ -372,7 +372,7 @@ "menu_title": "Free shipping customizations", "tags": "code-snippets", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/code-snippets/free_shipping_customization.md", - "hash": "c18884a45e4e1cc7b174820c2553d2722df95b98f6783c2700096a5b7e19bffd", + "hash": "1711cff54da5c39385d06ff8d8e0a055d3d25f68ee4855d93fefa940c8ffc916", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/code-snippets/free_shipping_customization.md", "id": "cac6f1ccd661588e9a5fa7405643e9c6d4da388e" }, @@ -389,7 +389,7 @@ "post_title": "Disabling Marketplace Suggestions Programmatically", "menu_title": "Disabling marketplace suggestions", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/code-snippets/disabling_marketplace_suggestions_programmatically.md", - "hash": "3d5bd50d64a46efaea99efb0a87dfdb8882cb83598b7be8a8154ad0e464eb6f5", + "hash": "e3bdbf4f1754e32608ff55dd54c1f6f717a11178cc7d8028ccd88ff98b07cb36", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/code-snippets/disabling_marketplace_suggestions_programmatically.md", "id": "94a7a28e5dd3d9394650e66abec2429445e87028" }, @@ -406,7 +406,7 @@ "menu_title": "Configuring special tax scenarios", "tags": "code-snippet, tax", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/code-snippets/configuring_special_tax_scenarios.md", - "hash": "128193e0e980f484f354c93e59d34c3948f112e4a1c99158cf3e5d9969db9352", + "hash": "acce5111eb917b7381d9bdcb260c72870e89d723195b86522050032741c5107c", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/code-snippets/configuring_special_tax_scenarios.md", "id": "a8ab8b6734ba2ac5af7c6653635d15548abdab2a" }, @@ -415,7 +415,7 @@ "menu_title": "Payment method support for refunds, subscriptions, pre-orders", "tags": "payment-methods", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/code-snippets/check_payment_method_support.md", - "hash": "6cae4b1fda5980c327c99d6bae8b1978fd05849f07179f0699a174b57d27b862", + "hash": "932efcdd53d6b84920dd086570dedbf9b4ddaea333e6196cceaa017727ac5465", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/code-snippets/check_payment_method_support.md", "id": "2919c9fc523bce46f43a5f35f821d0c6623c5ede" }, @@ -473,7 +473,7 @@ "categories": [] }, { - "content": "\nInterested in joining the Woo contributor community? The links in this doc summarize and direct you to the order of operations you will need to make your first contribution. If you are a seasoned WooCommerce developer, feel free to skip ahead and utilize the template links, or the reference docs and guides below.\n\n## Contributing to WooCommerce Core\n\nThe WooCommerce core plugin code can be found in our [monorepo](https://github.com/woocommerce/woocommerce). Here you can contribute to: \n\n- [WooCommerce Core Plugin](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce)\n- [WooCommerce Admin](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce-admin)\n- [WooCommerce Blocks](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce-blocks) \n\n### Code of Conduct\n\nContributing to an open source project requires cooperation amongst individuals and organziations all working to make our project a stable and safe place to build and ask questions. Please thoroughly read our [Code of Conduct](https://github.com/woocommerce/woocommerce/blob/trunk/SECURITY.md) to get familiar with our standards and processes.\n\n### Contributor Guidelines\n\nOur [contributor guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) layout the first steps to contributing.\n\n- [Prerequisites and developer tools to get started](https://github.com/woocommerce/woocommerce/blob/trunk/README.md#getting-started)\n- [PNPM commands, plugin development environment packages, and troubleshooting](https://github.com/woocommerce/woocommerce/blob/trunk/DEVELOPMENT.md)\n- [Coding standards, E2E testing links](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) \n\n### Templates, Bug Reports, and Feature Requests\n\n- [Pull Request template](https://github.com/woocommerce/woocommerce/blob/trunk/.github/PULL_REQUEST_TEMPLATE.md)\n- [Core Issue template](https://github.com/woocommerce/woocommerce/blob/trunk/.github/ISSUE_TEMPLATE.md)\n- [Bug Report template](https://github.com/woocommerce/woocommerce/blob/trunk/.github/ISSUE_TEMPLATE/1-bug-report.yml)\n- [Enhancement template](https://github.com/woocommerce/woocommerce/blob/trunk/.github/ISSUE_TEMPLATE/2-enhancement.yml)\n- [Feature requests](https://woocommerce.com/feature-requests/woocommerce/)\n\n### Security\n\nSecurity and safety for data management are incredibly important to us at Woo. Please check out the [Automattic security policy](https://automattic.com/security/) to learn about our foundational requirements.\n\nPlease report any vulnerabilities or security issues by reading through Woo's security policy [here](https://github.com/woocommerce/woocommerce/blob/trunk/SECURITY.md).\n\n\n\n\n\n", + "content": "\nInterested in joining the Woo contributor community? The links in this doc summarize and direct you to the order of operations you will need to make your first contribution. If you are a seasoned WooCommerce developer, feel free to skip ahead and utilize the template links, or the reference docs and guides below.\n\n## Contributing to WooCommerce Core\n\nThe WooCommerce core plugin code can be found in our [monorepo](https://github.com/woocommerce/woocommerce). Here you can contribute to: \n\n- [WooCommerce Core Plugin](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce)\n- [WooCommerce Admin](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce-admin)\n- [WooCommerce Blocks](https://github.com/woocommerce/woocommerce/tree/trunk/plugins/woocommerce-blocks) \n\n### Code of Conduct\n\nContributing to an open source project requires cooperation amongst individuals and organizations all working to make our project a stable and safe place to build and ask questions. Please thoroughly read our [Code of Conduct](https://github.com/woocommerce/woocommerce/blob/trunk/SECURITY.md) to get familiar with our standards and processes.\n\n### Contributor Guidelines\n\nOur [contributor guidelines](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) layout the first steps to contributing.\n\n- [Prerequisites and developer tools to get started](https://github.com/woocommerce/woocommerce/blob/trunk/README.md#getting-started)\n- [PNPM commands, plugin development environment packages, and troubleshooting](https://github.com/woocommerce/woocommerce/blob/trunk/DEVELOPMENT.md)\n- [Coding standards, E2E testing links](https://github.com/woocommerce/woocommerce/blob/trunk/.github/CONTRIBUTING.md) \n\n### Templates, Bug Reports, and Feature Requests\n\n- [Pull Request template](https://github.com/woocommerce/woocommerce/blob/trunk/.github/PULL_REQUEST_TEMPLATE.md)\n- [Core Issue template](https://github.com/woocommerce/woocommerce/blob/trunk/.github/ISSUE_TEMPLATE.md)\n- [Bug Report template](https://github.com/woocommerce/woocommerce/blob/trunk/.github/ISSUE_TEMPLATE/1-bug-report.yml)\n- [Enhancement template](https://github.com/woocommerce/woocommerce/blob/trunk/.github/ISSUE_TEMPLATE/2-enhancement.yml)\n- [Feature requests](https://woocommerce.com/feature-requests/woocommerce/)\n\n### Security\n\nSecurity and safety for data management are incredibly important to us at Woo. Please check out the [Automattic security policy](https://automattic.com/security/) to learn about our foundational requirements.\n\nPlease report any vulnerabilities or security issues by reading through Woo's security policy [here](https://github.com/woocommerce/woocommerce/blob/trunk/SECURITY.md).\n\n\n\n\n\n", "category_slug": "contributing", "category_title": "Contribute to Woo", "posts": [ @@ -586,7 +586,7 @@ "post_title": "Contributing Technical Documentation", "menu_title": "Contributing Docs", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/contributing-docs/contributing-docs.md", - "hash": "9675e241e87c899fab5371ceac75d55c5d0e1df1ae900bacaedaf793f25cd187", + "hash": "ee2eed4bc33ccbc4a84a2c73ee503f2df5a92183013e3f703bb439edab0a3fe3", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/contributing-docs/contributing-docs.md", "id": "71c1a72bfd4d5ae6aa656d4264b1bf3beb6eca1c" } @@ -618,7 +618,7 @@ "categories": [] }, { - "content": "\n\nThese documents are all dealing with extensibility in the various WooCommerce Blocks.\n\n## Imports and dependency extration\n\nThe documentation in this section will use window globals in code examples, for example:\n\n```js\nconst { registerCheckoutFilters } = window.wc.blocksCheckout;\n```\n\nHowever, if you're using `@woocommerce/dependency-extraction-webpack-plugin` for enhanced dependency management you can instead use ES module syntax:\n\n```js\nimport { registerCheckoutFilters } from '@woocommerce/blocks-checkout';\n```\n\nSee for more information.\n\n## Hooks (actions and filters)\n\n| Document | Description |\n| ----------------------------- | ------------------------------------------------------- |\n| [Actions](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/hooks/actions.md) | Documentation covering action hooks on the server side. |\n| [Filters](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/hooks/filters.md) | Documentation covering filter hooks on the server side. |\n| [Migrated Hooks](/docs/cart-and-checkout-legacy-hooks/) | Documentation covering the migrated WooCommerce core hooks. |\n\n## REST API\n\n| Document | Description |\n| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |\n| [Exposing your data in the Store API.](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/rest-api/extend-rest-api-add-data.md) | Explains how you can add additional data to Store API endpoints. |\n| [Available endpoints to extend with ExtendSchema](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/rest-api/available-endpoints-to-extend.md) | A list of all available endpoints to extend. |\n| [Available Formatters](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/rest-api/extend-rest-api-formatters.md) | Available `Formatters` to format data for use in the Store API. |\n| [Updating the cart with the Store API](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/rest-api/extend-rest-api-update-cart.md) | Update the server-side cart following an action from the front-end. |\n\n## Checkout Payment Methods\n\n| Document | Description |\n| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |\n| [Checkout Flow and Events](/docs/cart-and-checkout-checkout-flow-and-events/) | All about the checkout flow in the checkout block and the various emitted events that can be subscribed to. |\n| [Payment Method Integration](/docs/cart-and-checkout-payment-method-integration-for-the-checkout-block/) | Information about implementing payment methods. |\n| [Filtering Payment Methods](/docs/cart-and-checkout-filtering-payment-methods-in-the-checkout-block/) | Information about filtering the payment methods available in the Checkout Block. |\n\n## Checkout Block\n\nIn addition to the reference material below, [please see the `block-checkout` package documentation](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/packages/checkout/README.md) which is used to extend checkout with Filters, Slot Fills, and Inner Blocks.\n\n| Document | Description |\n|--------------------------------------------------------------------------------------------------| ----------------------------------------------------------------------------------------------------------------- |\n| [How the Checkout Block processes an order](/docs/cart-and-checkout-how-the-checkout-block-processes-an-order/) | The detailed inner workings of the Checkout Flow. |\n| [IntegrationInterface](/docs/cart-and-checkout-handling-scripts-styles-and-data/) | The `IntegrationInterface` class and how to use it to register scripts, styles, and data with WooCommerce Blocks. |\n| [Available Filters](/docs/category/cart-and-checkout-blocks/available-filters/) | All about the filters that you may use to change values of certain elements of WooCommerce Blocks. |\n| [Slots and Fills](/docs/cart-and-checkout-slot-and-fill/) | Explains Slot Fills and how to use them to render your own components in Cart and Checkout. |\n| [Available Slot Fills](/docs/cart-and-checkout-available-slots/) | Available Slots that you can use and their positions in Cart and Checkout. |\n| [DOM Events](/docs/cart-and-checkout-dom-events/) | A list of DOM Events used by some blocks to communicate between them and with other parts of WooCommerce. |\n| [Filter Registry](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/packages/checkout/filter-registry/README.md) | The filter registry allows callbacks to be registered to manipulate certain values. |\n| [Additional Checkout Fields](/docs/cart-and-checkout-additional-checkout-fields/) | The filter registry allows callbacks to be registered to manipulate certain values. |\n", + "content": "\n\nThese documents are all dealing with extensibility in the various WooCommerce Blocks.\n\n## Imports and dependency extraction\n\nThe documentation in this section will use window globals in code examples, for example:\n\n```js\nconst { registerCheckoutFilters } = window.wc.blocksCheckout;\n```\n\nHowever, if you're using `@woocommerce/dependency-extraction-webpack-plugin` for enhanced dependency management you can instead use ES module syntax:\n\n```js\nimport { registerCheckoutFilters } from '@woocommerce/blocks-checkout';\n```\n\nSee for more information.\n\n## Hooks (actions and filters)\n\n| Document | Description |\n| ----------------------------- | ------------------------------------------------------- |\n| [Actions](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/hooks/actions.md) | Documentation covering action hooks on the server side. |\n| [Filters](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/hooks/filters.md) | Documentation covering filter hooks on the server side. |\n| [Migrated Hooks](/docs/cart-and-checkout-legacy-hooks/) | Documentation covering the migrated WooCommerce core hooks. |\n\n## REST API\n\n| Document | Description |\n| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |\n| [Exposing your data in the Store API.](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/rest-api/extend-rest-api-add-data.md) | Explains how you can add additional data to Store API endpoints. |\n| [Available endpoints to extend with ExtendSchema](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/rest-api/available-endpoints-to-extend.md) | A list of all available endpoints to extend. |\n| [Available Formatters](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/rest-api/extend-rest-api-formatters.md) | Available `Formatters` to format data for use in the Store API. |\n| [Updating the cart with the Store API](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/third-party-developers/extensibility/rest-api/extend-rest-api-update-cart.md) | Update the server-side cart following an action from the front-end. |\n\n## Checkout Payment Methods\n\n| Document | Description |\n| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |\n| [Checkout Flow and Events](/docs/cart-and-checkout-checkout-flow-and-events/) | All about the checkout flow in the checkout block and the various emitted events that can be subscribed to. |\n| [Payment Method Integration](/docs/cart-and-checkout-payment-method-integration-for-the-checkout-block/) | Information about implementing payment methods. |\n| [Filtering Payment Methods](/docs/cart-and-checkout-filtering-payment-methods-in-the-checkout-block/) | Information about filtering the payment methods available in the Checkout Block. |\n\n## Checkout Block\n\nIn addition to the reference material below, [please see the `block-checkout` package documentation](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/packages/checkout/README.md) which is used to extend checkout with Filters, Slot Fills, and Inner Blocks.\n\n| Document | Description |\n|--------------------------------------------------------------------------------------------------| ----------------------------------------------------------------------------------------------------------------- |\n| [How the Checkout Block processes an order](/docs/cart-and-checkout-how-the-checkout-block-processes-an-order/) | The detailed inner workings of the Checkout Flow. |\n| [IntegrationInterface](/docs/cart-and-checkout-handling-scripts-styles-and-data/) | The `IntegrationInterface` class and how to use it to register scripts, styles, and data with WooCommerce Blocks. |\n| [Available Filters](/docs/category/cart-and-checkout-blocks/available-filters/) | All about the filters that you may use to change values of certain elements of WooCommerce Blocks. |\n| [Slots and Fills](/docs/cart-and-checkout-slot-and-fill/) | Explains Slot Fills and how to use them to render your own components in Cart and Checkout. |\n| [Available Slot Fills](/docs/cart-and-checkout-available-slots/) | Available Slots that you can use and their positions in Cart and Checkout. |\n| [DOM Events](/docs/cart-and-checkout-dom-events/) | A list of DOM Events used by some blocks to communicate between them and with other parts of WooCommerce. |\n| [Filter Registry](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/packages/checkout/filter-registry/README.md) | The filter registry allows callbacks to be registered to manipulate certain values. |\n| [Additional Checkout Fields](/docs/cart-and-checkout-additional-checkout-fields/) | The filter registry allows callbacks to be registered to manipulate certain values. |\n", "category_slug": "extensibility-in-blocks", "category_title": "Extensibility in Blocks", "posts": [], @@ -683,7 +683,7 @@ "post_title": "Integrating with coming soon mode", "tags": "how-to, coming-soon", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/extension-development/integrating-coming-soon-mode.md", - "hash": "d702df70aff95e040624ffc6f9c8383ef98df2616a508e8ba2b031a9743de7e5", + "hash": "910dbbab77c6fb4735e7704796242c38d86f3bf3b897de1075338eb47194f8f5", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/extension-development/integrating-coming-soon-mode.md", "id": "787743efb6ef0ad509b17735eaf58b2a9a08afbc" }, @@ -931,7 +931,7 @@ "menu_title": "Enable HPOS for large stores", "tags": "how-to", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/high-performance-order-storage/guide-large-store.md", - "hash": "77c0815ce6044a7e331a9cecd42c7a277392aa10dfe801b689d53880ef72064c", + "hash": "8bcae74d27e3a4ee9a902719c7e8d5aec4a4d82d7c14acd8665a72b9d4758181", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/high-performance-order-storage/guide-large-store.md", "id": "b6156ac7b77d75022867e9ebb968bc9c1c35f0da" }, @@ -1102,7 +1102,7 @@ { "post_title": "Extending the product form with generic fields", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/product-editor-development/how-to-guides/generic-fields-tutorial.md", - "hash": "a0e68f9d6027f8bcd4ef09cc33d5b3bf8c7169adad89c676569a97a6185dd261", + "hash": "759edf2a3b0e29fa4f54b0e2d582c96db91eb68c844d5c545c33f0d2c38e2cda", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/product-editor-development/how-to-guides/generic-fields-tutorial.md", "id": "f221ccb6d42c5e67a0a7916b955253ab7e546641" }, @@ -1221,7 +1221,7 @@ "menu_title": "Core critical flows", "tags": "reference", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/quality-and-best-practices/core-critical-flows.md", - "hash": "fe3f8ccf5f2096b28bb86214b71f0e7232a14bee1b4ad01b45b7ebecf5665de0", + "hash": "472f5a240abe907fec83a8a9f88af6699f2d994aa7ae87faa1716a087baa66db", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/quality-and-best-practices/core-critical-flows.md", "id": "e561b46694dba223c38b87613ce4907e4e14333a" }, @@ -1256,7 +1256,7 @@ "menu_title": "Extend analytics reports", "tags": "how-to", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/reporting/extending-woocommerce-admin-reports.md", - "hash": "f0da86ad096c564e54550a880a755ff7915ab892e1828d2b019937cbb330dc9f", + "hash": "b694b0e857d3ca60acdef2ffaae329a93f0a0243eacc4b192562c7f507f169b3", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/reporting/extending-woocommerce-admin-reports.md", "id": "3ef20148084c97d7f62b565b92df844392ac27f7" }, @@ -1284,7 +1284,7 @@ "post_title": "Getting started with the WooCommerce REST API", "menu_title": "Getting started", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/rest-api/getting-started.md", - "hash": "2f0d989ee0e95ee87a764b69b2448e641a38b845e2d9bbfbf716b078fb200eb8", + "hash": "38f3b452b833707fa131a099da28b250fd687f449727685d42b9a9d5d060a96c", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/rest-api/getting-started.md", "id": "ad7fceb11d06571fb060f72c414896b425d6b72b" } @@ -1378,7 +1378,7 @@ { "post_title": "Template structure & Overriding templates via a theme", "edit_url": "https://github.com/woocommerce/woocommerce/edit/trunk/docs/theme-development/template-structure.md", - "hash": "6099b3a45f91390d9dd239f496eaf531be2b638c666858d6a066051ce915176a", + "hash": "c0e346e7e21682bd645998f0607efe18f9f63601f53f4a53ab43248eefcab2d1", "url": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/theme-development/template-structure.md", "id": "34bfebec9fc45e680976814928a7b8a1778af14e" }, @@ -1731,5 +1731,5 @@ "categories": [] } ], - "hash": "f9d109f3f4a559fd581e0352724943500327c36c821086f3be280e73a6e33fb7" + "hash": "95e835afe855d5a898bfc31337d2a42b582794d5e1aaacb9b4a98cfc97748e05" } \ No newline at end of file diff --git a/docs/theme-development/template-structure.md b/docs/theme-development/template-structure.md index cb1b51aa6e7..4688eb53875 100644 --- a/docs/theme-development/template-structure.md +++ b/docs/theme-development/template-structure.md @@ -4,120 +4,148 @@ post_title: Template structure & Overriding templates via a theme --- -**Note:** this document is geared toward template development for classic themes. Check this other document for [block theme development](../../plugins/woocommerce-blocks/docs/designers/theming/README.md). -We are unable to provide support for customizations under our [Support Policy](http://woocommerce.com/support-policy/). If you -need to further customize a snippet, or extend its functionality, we highly -recommend [Codeable](https://codeable.io/?ref=z4Hnp), or a [Certified WooExpert](https://woocommerce.com/experts/). +**NOTE** This document makes reference to classic themes which use PHP templates. If you are working on a block theme with HTML templates, [please check the Theming docs for block themes](https://github.com/woocommerce/woocommerce/blob/trunk/plugins/woocommerce-blocks/docs/designers/theming/README.md). +Overview --- + ## Overview ---- +WooCommerce template files contain the markup and template structure for the frontend and HTML emails of your store. + +Below is video walkthrough showing how one may go about updating the template files. -WooCommerce template files contain the **markup** and **template structure** for **frontend and HTML emails** of your -store. [![Documentation for Template structure & Overriding templates via a theme](https://embed-ssl.wistia.com/deliveries/a2f57c5896505b39952aa8411a474066.jpg?image_play_button_size=2x&image_crop_resized=960x540&image_play_button=1&image_play_button_color=694397e0)](https://woocommerce.com/document/template-structure/?wvideo=8mvl4bro0g) -When you open these files, you will notice they all contain **hooks** that allow you to add/move content without needing -to edit template files themselves. This method protects against upgrade issues, as the template files can be left -completely untouched. -## Template List +## Template list + +The various template files on your WooCommerce site can be found via an FTP client or your hosts file manager, in `/wp-content/plugins/woocommerce/templates/`. Below are links to the current and earlier versions of the WooCommerce template files on Github, where you can view the code exactly as it appears in those files: + +| Latest Version | Files | +| -------------- | ----- | +| 8.9 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.9.0/plugins/woocommerce/templates) | + +Below are the links to the files of all major previous WooCommerce versions: + +| Version | Files | +| -------------- | ----- | +| 8.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.8.0/plugins/woocommerce/templates) | +| 8.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.7.0/plugins/woocommerce/templates) | +| 8.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.6.0/plugins/woocommerce/templates) | +| 8.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.5.0/plugins/woocommerce/templates) | +| 8.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.4.0/plugins/woocommerce/templates) | +| 8.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.3.0/plugins/woocommerce/templates) | +| 8.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.2.0/plugins/woocommerce/templates) | +| 8.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.1.0/plugins/woocommerce/templates) | +| 8.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.0.0/plugins/woocommerce/templates) | +| 7.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.9.0/plugins/woocommerce/templates) | +| 7.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.8.0/plugins/woocommerce/templates) | +| 7.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.7.0/plugins/woocommerce/templates) | +| 7.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.6.0/plugins/woocommerce/templates) | +| 7.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.5.0/plugins/woocommerce/templates) | +| 7.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.4.0/plugins/woocommerce/templates) | +| 7.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.3.0/plugins/woocommerce/templates) | +| 7.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.2.0/plugins/woocommerce/templates) | +| 7.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.1.0/plugins/woocommerce/templates) | +| 7.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.0.0/plugins/woocommerce/templates) | +| 6.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.9.0/plugins/woocommerce/templates) | +| 6.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.8.0/plugins/woocommerce/templates) | +| 6.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.7.0/plugins/woocommerce/templates) | +| 6.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.6.0/plugins/woocommerce/templates) | +| 6.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.5.0/plugins/woocommerce/templates) | +| 6.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.4.0/plugins/woocommerce/templates) | +| 6.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.3.0/plugins/woocommerce/templates) | +| 6.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.2.0/plugins/woocommerce/templates) | +| 6.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.1.0/plugins/woocommerce/templates) | +| 6.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.0.0/plugins/woocommerce/templates) | +| 5.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.9.0/templates) | +| 5.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.8.0/templates) | +| 5.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.7.0/templates) | +| 5.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.6.0/templates) | +| 5.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.5.0/templates) | +| 5.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.4.0/templates) | +| 5.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.3.0/templates) | +| 5.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.2.0/templates) | +| 5.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.1.0/templates) | +| 5.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.0.0/templates) | +| 4.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.9.0/templates) | +| 4.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.8.0/templates) | +| 4.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.7.0/templates) | +| 4.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.6.0/templates) | +| 4.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.5.0/templates) | +| 4.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.4.0/templates) | +| 4.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.3.0/templates) | +| 4.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.2.0/templates) | +| 4.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.1.0/templates) | +| 4.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.0.0/templates) | +| 3.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.9.0/templates) | +| 3.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.8.0/templates) | +| 3.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.7.0/templates) | +| 3.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.6.0/templates) | +| 3.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.5.0/templates) | +| 3.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.4.0/templates) | +| 3.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.3.0/templates) | +| 3.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.2.0/templates) | +| 3.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.1.0/templates) | +| 3.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.0.0/templates) | +| 2.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/2.6.0/templates) | + + +## Changing Templates via Hooks + +When you open a template file, you will notice they all contain _hooks_ that allow you to add/move content without needing to edit template files themselves. Hooks are a way for one piece of code to interact/modify another piece of code at specific, pre-defined spots. This method allows implementing a code snippet that “hooks” into a particular a theme location. It avoids upgrade issues, as the template files can be left completely untouched and doesn't require a child theme to be configured. + +Let's take a look at [/wp-content/plugins/woocommerce/templates/emails/admin-new-order.php](https://github.com/woocommerce/woocommerce/blob/8.9.0/plugins/woocommerce/templates/emails/admin-new-order.php) and see what a hook looks like. Starting on line 30, we see the following code, which is responsible for producing the order details section of the New Order email. + +```php +/* + * @hooked WC_Emails::order_details() Shows the order details table. + * @hooked WC_Structured_Data::generate_order_data() Generates structured data. + * @hooked WC_Structured_Data::output_structured_data() Outputs structured data. + * @since 2.5.0 + */ +do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email ); +``` + +The code above outputs the block highlighted in red in the image below, which is the New Order email a shop manager receives following a successful order on their site: + +![image](https://woocommerce.com/wp-content/uploads/2020/05/templating-using-hooks.webp) + +A code below can be used as a starting point to build out desired functionality. It can then be added to a code snippets plugin to modify the output at that particular location in the template, without having to edit the template itself. The same goes for other hooks, wherever in the templates they may appear. + +```php +add_action( 'woocommerce_email_order_details', 'my_custom_woo_function'); +function my_custom_woo_function() { + /* Your code goes here */ +} +``` + +## Changing Templates by Editing the Files + +Editing files directly in a plugin or a parent theme creates the risk of causing errors that could bring a site to a grinding halt. But more importantly, any changes made in this way will disappear when the plugin or theme updates itself; a process that entirely deletes the old version and replaces it with a fresh, updated copy. + +Instead, the recommended approach is to [set up a child theme](https://developer.woocommerce.com/docs/how-to-set-up-and-use-a-child-theme/), which creates a safe directory where to make overriding changes that will not be automatically updated. + +For this example, let's call our child theme `storefront-child`. With `storefront-child` in place, edits can be made in an upgrade-safe way by using overrides. Copy the template into a directory within your child theme named `/storefront-child/woocommerce/` keeping the same file structure but removing the `/templates/` subdirectory. + +To override the admin order notification in our example, copy `wp-content/plugins/woocommerce/templates/emails/admin-new-order.php` to `wp-content/themes/storefront-child/woocommerce/emails/admin-new-order.php` + +The copied file will now override the WooCommerce default template file, so you can make any changes you wish to the copied file, and see it reflected in the resulting output. --- -Template files can be found within the **/woocommerce/templates/** directory: - -| Latest version | Files | -|:---------------|:-----------------------------------------------------------------------------------------------------------| -| v8.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.4.0/plugins/woocommerce/templates) | - ---- - -
-Expand to view files of all major previous versions - -| Version | Files | -|---------|------------------------------------------------------------------------------------------------------------| -| v8.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.3.0/plugins/woocommerce/templates) | -| v8.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.2.0/plugins/woocommerce/templates) | -| v.8.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.1.0/plugins/woocommerce/templates) | -| v8.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/8.0.0/plugins/woocommerce/templates) | -| v7.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.9.0/plugins/woocommerce/templates) | -| v7.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.8.0/plugins/woocommerce/templates) | -| v7.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.7.0/plugins/woocommerce/templates) | -| v7.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.6.0/plugins/woocommerce/templates) | -| v7.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.5.0/plugins/woocommerce/templates) | -| v7.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.4.0/plugins/woocommerce/templates) | -| v7.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.3.0/plugins/woocommerce/templates) | -| v7.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.2.0/plugins/woocommerce/templates) | -| v7.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.1.0/plugins/woocommerce/templates) | -| v7.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/7.0.0/plugins/woocommerce/templates) | -| v6.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.9.0/plugins/woocommerce/templates) | -| v6.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.8.0/plugins/woocommerce/templates) | -| v6.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.7.0/plugins/woocommerce/templates) | -| v6.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.6.0/plugins/woocommerce/templates) | -| v6.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.5.0/plugins/woocommerce/templates) | -| v6.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.4.0/plugins/woocommerce/templates) | -| v6.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.3.0/plugins/woocommerce/templates) | -| v6.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.2.0/plugins/woocommerce/templates) | -| v6.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.1.0/plugins/woocommerce/templates) | -| v6.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/6.0.0/plugins/woocommerce/templates) | -| v5.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.9.0/templates) | -| v5.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.8.0/templates) | -| v5.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.7.0/templates) | -| v5.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.6.0/templates) | -| v5.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.5.0/templates) | -| v5.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.4.0/templates) | -| v5.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.3.0/templates) | -| v5.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.2.0/templates) | -| v5.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.1.0/templates) | -| v5.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/5.0.0/templates) | -| v4.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.9.0/templates) | -| v4.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.8.0/templates) | -| v4.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.7.0/templates) | -| v4.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.6.0/templates) | -| v4.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.5.0/templates) | -| v4.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.4.0/templates) | -| v4.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.3.0/templates) | -| v4.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.2.0/templates) | -| v4.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.1.0/templates) | -| v4.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/4.0.0/templates) | -| v3.9.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.9.0/templates) | -| v3.8.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.8.0/templates) | -| v3.7.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.9.0/templates) | -| v3.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.6.0/templates) | -| v3.5.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.5.0/templates) | -| v3.4.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.4.0/templates) | -| v3.3.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.3.0/templates) | -| v3.2.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.2.0/templates) | -| v3.1.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.1.0/templates) | -| v3.0.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/3.0.0/templates) | -| v2.6.0 | [View template files](https://github.com/woocommerce/woocommerce/tree/2.6.0/templates) | -
- +**Note** A (desirable) side-effect of your templates being upgrade-safe is that WooCommerce core templates will update, but your custom overrides will not. You may occassionally see notices in your System Status report that says, e.g. “version 3.5.0 is out of date. The core version is 3.7.0″. Should that happen, follow the Fixing Outdated WooCommerce Templates guide to bring them in line. --- -## How to Edit Files - ---- - -Edit files in an **upgrade-safe** way using **overrides**. Copy the template into a directory within your theme named `/woocommerce` keeping the same file structure but removing the `/templates/` subdirectory. - -Example: To override the admin order notification, copy: `wp-content/plugins/woocommerce/templates/emails/admin-new-order.php` to `wp-content/themes/yourtheme/woocommerce/emails/admin-new-order.php`. - -The copied file will now override the WooCommerce default template file. - -**Warning:** Do not edit these files within the core plugin itself as they are overwritten during the upgrade process and any customizations will be lost. For more detailed information, see [Fixing Outdated WooCommerce Templates](https://woocommerce.com/document/fix-outdated-templates-woocommerce/). - -## For Custom Templates +## Declare Theme Support for Custom Templates If you are a theme developer or using a theme with custom templates, you must declare WooCommerce theme support using the `add_theme_support` function. See [Declaring WooCommerce Support in Themes](https://github.com/woocommerce/woocommerce/wiki/Declaring-WooCommerce-support-in-themes) at GitHub. -If your theme has a `woocommerce.php` file, you will be unable to override the `woocommerce/archive-product.php` custom template in your theme, as `woocommerce.php` has priority over other template files. This is intended to prevent display issues. +If your theme has `woocommerce.php`, you will be unable to override `woocommerce/archive-product.php` custom template in your theme, as `woocommerce.php` has priority over other template files. This is intended to prevent display issues. --- diff --git a/plugins/woocommerce/changelog/docs-check_payment_method_support b/plugins/woocommerce/changelog/docs-check_payment_method_support new file mode 100644 index 00000000000..db706fcadc7 --- /dev/null +++ b/plugins/woocommerce/changelog/docs-check_payment_method_support @@ -0,0 +1,4 @@ +Significance: minor +Type: enhancement + +Fixed minor issues in the developer documentation recently added by public resources team