From 78ff09315da963873383e8773b1e5f04cfe98550 Mon Sep 17 00:00:00 2001 From: liangshiwei Date: Wed, 19 May 2021 22:28:55 +0800 Subject: [PATCH 1/4] Update bookstore document --- docs/en/Tutorials/Part-1.md | 18 ++++++------------ docs/en/Tutorials/Part-10.md | 10 ++++++---- docs/en/Tutorials/Part-7.md | 18 ++++++++++++------ .../bookstore-efcore-migration-authors.png | Bin 0 -> 35168 bytes .../images/bookstore-efcore-migration.png | Bin 0 -> 30521 bytes docs/zh-Hans/Tutorials/Part-1.md | 16 ++++++---------- .../images/bookstore-efcore-migration.png | Bin 0 -> 30521 bytes 7 files changed, 30 insertions(+), 32 deletions(-) create mode 100644 docs/en/Tutorials/images/bookstore-efcore-migration-authors.png create mode 100644 docs/en/Tutorials/images/bookstore-efcore-migration.png create mode 100644 docs/zh-Hans/Tutorials/images/bookstore-efcore-migration.png diff --git a/docs/en/Tutorials/Part-1.md b/docs/en/Tutorials/Part-1.md index 26d6e51c1a..7000e39d8c 100644 --- a/docs/en/Tutorials/Part-1.md +++ b/docs/en/Tutorials/Part-1.md @@ -177,25 +177,19 @@ namespace Acme.BookStore.EntityFrameworkCore ### Add Database Migration -The startup template uses [EF Core Code First Migrations](https://docs.microsoft.com/en-us/ef/core/managing-schemas/migrations/) to create and maintain the database schema. Open the **Package Manager Console (PMC)** under the menu *Tools > NuGet Package Manager*. +The startup solution is configured to use [Entity Framework Core Code First Migrations](https://docs.microsoft.com/en-us/ef/core/managing-schemas/migrations/). Since we've changed the database mapping configuration, we should create a new migration and apply changes to the database. -![Open Package Manager Console](images/bookstore-open-package-manager-console.png) - -Select the `Acme.BookStore.EntityFrameworkCore.DbMigrations` as the **default project** and execute the following command: +Open a command-line terminal in the directory of the `Acme.BookStore.EntityFrameworkCore.DbMigrations` project and type the following command: ```bash -Add-Migration "Created_Book_Entity" +dotnet ef migrations add Created_Book_Entity ``` -![bookstore-pmc-add-book-migration](./images/bookstore-pmc-add-book-migration-v2.png) - -> If you get an error like "*Your startup project ... doesn't reference Microsoft.EntityFrameworkCore.Design. This package is required for the Entity Framework Core Tools to work*", right click to the `Acme.BookStore.EntityFrameworkCore.DbMigrations` project and **Set as the Startup Project** and try again. - -This will create a new migration class inside the `Migrations` folder of the `Acme.BookStore.EntityFrameworkCore.DbMigrations` project. +This will add a new migration class to the project: -Before updating the database, read the section below to learn how to seed some initial data to the database. +![bookstore-efcore-migration](./images/bookstore-efcore-migration.png) -> If you are using another IDE than the Visual Studio, you can use `dotnet-ef` tool as [documented here](https://docs.microsoft.com/en-us/ef/core/managing-schemas/migrations/?tabs=dotnet-core-cli#create-a-migration). +> If you are using Visual Studio, you may want to use `Add-Migration Created_Book_Entity -c BookStoreMigrationsDbContext` and `Update-Database -c BookStoreMigrationsDbContext` commands in the *Package Manager Console (PMC)*. In this case, ensure that {{if UI=="MVC"}}`Acme.BookStore.Web`{{else if UI=="BlazorServer"}}`Acme.BookStore.Blazor`{{else if UI=="Blazor" || UI=="NG"}}`Acme.BookStore.HttpApi.Host`{{end}} is the startup project and `Acme.BookStore.EntityFrameworkCore.DbMigrations` is the *Default Project* in PMC. {{end}} diff --git a/docs/en/Tutorials/Part-10.md b/docs/en/Tutorials/Part-10.md index a47db03051..09df003703 100644 --- a/docs/en/Tutorials/Part-10.md +++ b/docs/en/Tutorials/Part-10.md @@ -86,14 +86,14 @@ builder.Entity(b => ### Add New EF Core Migration -Run the following command in the Package Manager Console (of the Visual Studio) to add a new database migration: +The startup solution is configured to use [Entity Framework Core Code First Migrations](https://docs.microsoft.com/en-us/ef/core/managing-schemas/migrations/). Since we've changed the database mapping configuration, we should create a new migration and apply changes to the database. + +Open a command-line terminal in the directory of the `Acme.BookStore.EntityFrameworkCore.DbMigrations` project and type the following command: ````bash -Add-Migration "Added_AuthorId_To_Book" +dotnet ef migrations add Added_AuthorId_To_Book ```` -> Ensure that the `Acme.BookStore.EntityFrameworkCore.DbMigrations` is the Default project and the `Acme.BookStore.DbMigrator` is the startup project, as always. - This should create a new migration class with the following code in its `Up` method: ````csharp @@ -121,6 +121,8 @@ migrationBuilder.AddForeignKey( * Creates an index on the `AuthorId` field. * Declares the foreign key to the `AppAuthors` table. +> If you are using Visual Studio, you may want to use `Add-Migration Added_AuthorId_To_Book -c BookStoreMigrationsDbContext` and `Update-Database -c BookStoreMigrationsDbContext` commands in the *Package Manager Console (PMC)*. In this case, ensure that {{if UI=="MVC"}}`Acme.BookStore.Web`{{else if UI=="BlazorServer"}}`Acme.BookStore.Blazor`{{else if UI=="Blazor" || UI=="NG"}}`Acme.BookStore.HttpApi.Host`{{end}} is the startup project and `Acme.BookStore.EntityFrameworkCore.DbMigrations` is the *Default Project* in PMC. + {{end}} ## Change the Data Seeder diff --git a/docs/en/Tutorials/Part-7.md b/docs/en/Tutorials/Part-7.md index e359a3d22f..312255e74c 100644 --- a/docs/en/Tutorials/Part-7.md +++ b/docs/en/Tutorials/Part-7.md @@ -70,19 +70,25 @@ This is just like done for the `Book` entity before, so no need to explain again ## Create a new Database Migration -Open the **Package Manager Console** on Visual Studio and ensure that the **Default project** is `Acme.BookStore.EntityFrameworkCore.DbMigrations` in the Package Manager Console, as shown on the picture below. Also, set this project as the **startup project** (right click it on the solution explorer and click to "Set as Startup Project"). +The startup solution is configured to use [Entity Framework Core Code First Migrations](https://docs.microsoft.com/en-us/ef/core/managing-schemas/migrations/). Since we've changed the database mapping configuration, we should create a new migration and apply changes to the database. -Run the following command to create a new database migration: +Open a command-line terminal in the directory of the `Acme.BookStore.EntityFrameworkCore.DbMigrations` project and type the following command: ````bash -Add-Migration "Added_Authors" +dotnet ef migrations add Added_Authors ```` -![bookstore-add-migration-authors](images/bookstore-add-migration-authors.png) +This will add a new migration class to the project: -This will create a new migration class. Then run the `Update-Database` command to create the table on the database. +![bookstore-efcore-migration-authors](./images/bookstore-efcore-migration-authors.png) -> See the [Microsoft's documentation](https://docs.microsoft.com/en-us/ef/core/managing-schemas/migrations/) for more about the EF Core database migrations. +You can apply changes to the database using the following command, in the same command-line terminal: + +````bash +dotnet ef database update +```` + +> If you are using Visual Studio, you may want to use `Add-Migration Added_Authors -c BookStoreMigrationsDbContext` and `Update-Database -c BookStoreMigrationsDbContext` commands in the *Package Manager Console (PMC)*. In this case, ensure that {{if UI=="MVC"}}`Acme.BookStore.Web`{{else if UI=="BlazorServer"}}`Acme.BookStore.Blazor`{{else if UI=="Blazor" || UI=="NG"}}`Acme.BookStore.HttpApi.Host`{{end}} is the startup project and `Acme.BookStore.EntityFrameworkCore.DbMigrations` is the *Default Project* in PMC. {{else if DB=="Mongo"}} diff --git a/docs/en/Tutorials/images/bookstore-efcore-migration-authors.png b/docs/en/Tutorials/images/bookstore-efcore-migration-authors.png new file mode 100644 index 0000000000000000000000000000000000000000..a702875c718148f2d087e8690b6982640bcb93e1 GIT binary patch literal 35168 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�TQ?7{wJwqbNuBPH&u{2j1p#sB|z+H}MH( zc4!ZerE;KEYQSIN5sMQAv`f(!7PLe3&B{hxVr=}}ewFR+ZZ8tblRC47ccXs)&kOKH zoI7|EQFITrS{lR4rd`+$JpT1kw304(sSx+?-2>upT*reVpSj$Ij*|IxOjRt?>%bL} z@(^W_;t=Jr|C!fuAC>^JtCQ|NlwiL_pR9Bp+Ob0aCIO6E$)|fJ5Dw}YWaXQ#qNe#f z!cFmpP@EnMsIOh6@Y=e>t}tlL6bAF=#E_Gay(?E^q(HUk>CaF5ejl(29>Wtk zHofL78%OEn5lckFsh^$N*PGYA!l2i^{zCBWc~GsLL);e%;U~;2;-!_8aN_MhUt8aX zO4*6>*D2J5LL!!$lY(t0s(bmwO;^fr)V#d(_=vJ0w^x)F+A~Tg=B1*d@+pE#Stif% z&kTu!{k}c|Q7F_=hNCz(9?$H2J$nPdkR#(OzQ|{03hmwgfK!|o-kOc^xh>ckjxqZ7 zm^ZX(ii%-4MwBuOdh24&cV2+v7jtEG8LB2(>ofj=P(w86WEW|3+`N3?)%BA~omK{B z<$C4rOF^wh>v#5{FQu4&0!6>X@3@JSk#NZ+?`HMOb}(dUcL1s|Jw3fAj!CM6*|c58szH;p!Hx>jzF<+)ueDnEJUc{6IgH_V$;1o zp*k^mF+vBAb4z^mfe42k=bi${mJ0s#RL%*@5^;#Q_5PqWs- zL=&54x|;!1de7Ihun~M#)kNpsbf;kb!_v{&z0=gwha9^7_+b{mG>KGo~ z@2U-ksV-lSL!9WV|F5HsU~;wU7L(j7zlv3o)bG}PNPs=zw^WCvyTa4=;Xe`3h#fIvSAlxjG&tAcEfH0$3u%B8?yn7EHO>Vy@)^2p-^8 z5dYk8M)Xu^IIW7#ZCieK_sF7Jmgtr>6(#H1y*i!Zmodksq%fZM7ERX?5<^2&;w1sz zs79v7r0nf*IQJ%yf+!oi`KIgzS)6*2tWNJVk$(9u5?CWo4ycW|FeWUyx{ErQ9&+{iXZE^X2|*`52F- zGQCaTghJSo!+QBLZOSVcBi1ko(TrzaooIsGiMb9Bcr!tvOCn3&y-oBVwhV@h>|9T~ zocwmc=pX*LeBpJ#GmDMpm51UO>?K!X8qpH?L+$e9<8|s|WT{jT8-9X1QR-h&CL~Fr z^8vv=<-jng6BN&dYllH@l-h#mhop?cR6K4^tCYj z>m&-uxItiDP^8iJsxD+IE&_mEix5@NKe{DpFApH`4Yw`WVv84aGkZ3_ec_h%w-V#m;0lb=e1VHJD7jJLHdV% z>j~VK593rb)3MTJlyjW-b-d-fcu8SnP$K_}sCouO^|!wQd=oeVR(;)){l2%48rzeS zTZ;UDen&y^FWizJC*O|9fWifO)CXh*g$#&}nYjwy+w&=cYX1gIP7Y#3V3v{8xNFyS zHU0W@gTe{4B_CV&E;NuP*dvAdw=QUZrY0Vf;b6L?YH;H$jpVkC-DL%){nCX=ZlTDi84@@e8{%n^N#Y#pJ`v-&+Bwqi{aJq z!L3k%^5VgL{Tu&a)%Fdgd_fjxIQ!nJSG%#3l|8@S(dW-F3DAj zb?Ge&P%h%mUUpY4~}>Crn? zoC8;Vg|!+{DbNm6JP-DBy=!8@@qVVKV@FG(jHh=du*M-rN5v$r$nq~mAGh5{ZVQiV zwI3T1PjYG=v{6xy3dVlU|D8ERl7J5RM1|whPMaC^`|J`r9nuu-1*2XjrAe1lv&?~K zoSY!Ec{EF#_V-P_Y=#z>i%PpQe8kAb*$Z?o z#FPg4nci@dyz79Tk;-v;NWRLL$}grCd#(|*u)rHg8rspZaf6?wn@t=;Q*k$H&PlY% zIT2>{Nt&8K>OP$V_a-;%1|+5!_$GD2>_t$Of^OeN4Ez|yj`Hz!bqy&`9I{xeI`PY$ zfi(fdD#2Nj-*~#Vk9w;8{23NmJ$+^E7CKp8a#ilRiS|d2HNp{kt?XH z>waScR^^?#V(a91D>=b~U%6e@E~SEX4m!YslW0YY>wX*vxYWel3UY9*y`ti24Sz%F zHDIckSJRY(_6_T5Mm8Zj+PEI#XN>hGrW=2E1k!(p*-I%NIlZQc7 zc!WsPA{aT+Di5~0*H>G2DU8z{_&Sn%lYoQ?EF)8nG1J?pj-#VA4J^->XZ3olV!}Eh ziDB{|>bumy$}`inlnm#IvZ~t3cawcG5xxc=LS%>(9L86(`pwXNg13U@Em}(uLfArS z(TM=FslTxVVOR^wK$r=2EvHasXh#rS`so%_KyOo5v1zBa!X2@&Yl4>sByAOQ2Hyl| zg3@LkHAa~{4(yqnO;9dGm_7*T)_FWb5#zq?A5qi$*OxI)e}gnAjJR2O5t2DW3d)9C)w0q0nq-F@@ZD9p z1T!jWWrdr#2+?4=V9KE1LWckpi9$+9`gflGC`hOQpni}k#5uj9!bg1^Sj>zFeWX(f%d@K%Gh0EAmK(D!&Eh>+i@QtT@v zDVS@t%C>PqMV+`>mt~(O1TEFlJPA^t|=IlJ%Gayl{s>o*XQ5X;;+P1&}-bM`IdaG`O-^ z)ZXCpoOEpWT)|e}rG@I*c7b9foM4@A1w-?=(TD)Mu~1k)a>p7#;_#jCb0!$SrVf&0 zYBW@tXSVhkI)&s@xJptNn`%6kSwA~c&K72ixeyAIhn&>z4b}DPGpJT;`ip7pLW(Jp_(&s0-U|crg;n&1&|X-jQSksWc&6W?Y=5 zfT|r^K5;}h$J-PD1_CgmMyK_I)QQ1wFYtKWoSZ-~Cb;+(K{y!GNjgv!*+1RU^Z5_q5>~lxw zS49XZ{GNk^%e<@46ivpBt!*8;^?U+zrUMjm_rae7k~G2>;kp*jlxt}W%VFJJD!M&6 zl6Aljxa;QZI`MF%ON)pCIqwk){ivGH*}o(irX9Tr+mqyV4Go_}so!cSHnrw{{t3Z3 z0jY|#(ylencD`r?LIeu&8&vD#0vNuS3=!7w z8YywuYb#BQdwn+Bk$#nS*cWJLcK9+``y@!MB?3}RI^dZbZp(_Ga5!~=gb*@Z>;Bwh zO*5EP^hc58DH)za924nPD&Iq1^ zI^l`4!KO~%z?z}09V{*6Liw|tV_ZR9zJRo|u%(t)@$6=x4=#CF6T%{xm;Z(p1rdHk zJUpIGTDVb*TcBO`zl4RmHlHr1-o0+m>H)L{9$aV0GWbp9VrBj4eFaWF5cMAh5nvWa z05P(29V&3Pc8+b;nBQC0#EDS$f|5x13U#DTDQxqH)Mm^>l(abadZCpa z`iv*vH5bJ=J)R%9i$DGOjPWkw50_XdM99|a2r$e8?Buf8u_%?HMdm8WTP#1n7>Jo_ zP1NQGB3ELCk^D{p^bHArX8;JbvT5<@Iw*EBB*Z4Qd%9W^>`$hxC_B+bx_=wJhb%O$ zoL=6M#{SP?PY+_$!6AGMBE$EmB0oe)4FJSfaWOA5`UmMr0s#;o5?IFY9|BfJ2SEHp zJk8_3nR{RlBoP4O3-`pU|AYLAVty?wCLzh(;(zlBMqvQNk4CH|{RjC8O^_si!GRj$ zv3QN_9WPWo7pZuZfW1}E{l)o^z-)hk{^R?-1c7%UxVU?E=BAR;v836*9u)-se^?*o zdK1@s>ct1yS6WQPV)Wm`3rs0ca(Y+kfwGS@1+S6F7Dv(x!T3MVDS947027PCzbunN ze-s10&ncAiJW$5qU;R&Qkd*~hPUaB+NCTxL(gRp%#MJ+C6U68qOvi)Mm3jbgjZvM< zYqog00(f2#5=A)`NtTs4f9PuM@qPUKFUKsyfUIR|t)*bCCyD(hDKHA^QLnxjAJx2` zuzNd`PnV6)6)+HZ;zi17JBcNM=;&X-T?Uii_(vCsp{jI4F-LAf0FO(W9-xc z3z`%Dv;rN9 zTOe5G<`QNMlW+gy$a`WD zF=fsJ^V4tB1h;XK(H+pvEiG9z9a-v`@9*!ZKm)4s)7uz-Q6^yAoj2*L~RMP`r#$;ILAkwWwIVv~5H?-7Fo3iB- zYhJd(H?W>L-`6!5?WmZr(|7+%53*1V6O@R& zDxJpgC9nu18v~!M^34P1X6qWqdtpMnKZ{w24`PHxGcdDz`}AI>k_sGj!#=}%$+xiATUw3tek9y0q&uB;(BU(Q?%0bc@L*Q z0;(7pk)lLOTdY=DY_Cnbf^m6KTd%udVUO)6wDgz^t)XIkvxS-W8*s|h#e=g5Ep&tE z^g!KJ+=PkC@^DoZrArSV;qvvO+840hzB)=gxEO_+L zVb00sl_wJa4m^Z|h?qw02?bQm{4!nk9L&Qo4#KJ;n_cJ+<;qsc{k{WOk(eNLX#3b; z50gXu-$Wjg{Z%18DK!}vbru*{h)uNFUk5s$Z0P7rL~*h1VtAcr$u$annpxQx9G~mi zwbIk`w6hDQ@s~@Z>RX zL9c2JWRX-$FeGX@rC!Jg9_apmfRqFz8hJyJ7UTt+z_+g*YOW55s2TN_e7JdmI;kSo zpU^*q1oC4r3&?g2$xOeNN7r^@YTP73mAhV)!`fA%B`LKQ=Uc1R*pkMaca;L@J|UKq zx_o*@EqO3?>C}@~qe`uMGJ3$w&7xLR-~JZvv7(rg`=4s#aes@*vR_m4%ZJ~Rg*{Ba z$T!jH^vouzuhj-@UBT)9oUTmOKn;XdaVw3L20OP^9T$Qw?lDADof#=HJfR(xs#9YO zT}dQ|{KRj!n;ut9C|>4b#a1j6#8?+s{*V6Ifd|}bfp8jjA}EWdyGdyJoguvU5+%Ts zEz4=8+URDWX0#DAQG2m*^jhEJYxZj8%;u8QAzayTVDDd{2SG9-x8W|i+O>kW9GldI zPhsk;+Y;gb^j;amzwl-yTCWu8@#p*(^D&k|%$I&o=ppC5z8@NmgKj+wXGpRdO>5&q zt}*)cCxZS>ZR;o2)^TKgj{g_Og&ZcJIQ|2GNV39aZm0-N%~j1t7(xFp?^`@!e%--lOG@Maum%xMC2|pLL zC6D@wT^>w>1?Vpsm}$G;nNMlvS4zodH6Ci!*3=+rBThnj0XkI@L-0&_;pmN1yZ6%< zbV}43&?G@_vOhtj42co&ijtx+z=0|REgv9%NRB-45WKJC#B_PPoUgSyP$8RSXm zM|E>*r9;OOx}aksX^>0gB2sdg-6{Bt_X`~)q(9_;=|FatOt=!YQASJJ%-JZp!S&V+KK z*0U|@(`sclZC4;FhQ%Z#rT(ldIXp<&k1X(Szu)mleK^+RKeDy$ca`)T^M4TvAiI_Tu(Pi*M0bB5t_tfr{jO4{qm1oO zmmvMGVtP1N7`@#Djr82S;5^-!^XI!f?x@or4+~=4TBQ=me`(Qs33wRmwmDHLd!uHs z+h`V6B>p3qV*?=z`CUy-=$>{<_&co*?&nGrVg`Wxn1!N{twu9?4z!CEa^Ue73~UqQ z)bd#WtW2QbH3{R2H9JLjvV#?;=Va#W_nL_`mIIWWmNNxkFOlK*h#Dx!0fSWQ7PgDU zqCJ@uJN0apY$LiRz;gh%p*5_M4KC*+kb2JE$}x6Ynn(HG#3Pkw&u0OEIl}kXX19LZ z`t8ByJ601Fhr*7EpQW5E=;g{1#fOj4Vq&)1<|`pGNL^yw(%v2&1x}2|p|?CdY!MVN z9H{czIj`&e>Hp(qI9c@dK8VgCn|}VSY444t0G^ptJ(sB7jNgztl}w~3`&eN*UICj)?n&oIFnK4kS6 zB48BPQ}je9Lo>PrMYmb$Se}!ilur2@vq)7Vzu3F(v74px;gvyk3y_o;igYc6>V~dc zTUv6?Vtm1qGnW>;11Kfzb=)*NC$<35ai$Dt6j|;^si0UAq9?Q16NJ!G+;j~q)#CR!bzd6T=G$QhxaV{BWFph)x`)9_@cfBxLNOFtu==_sd& zw7trxVc0I0aCgMrrv1jN*Wl2n)A`=S^M@;zc1)p5<~Af0%>*f@|^q z)=M3*brU>GTQnEA+1-$D31BZcwrr~}&}Hw(J30WWBH=}G7bp?QYVtmgwUwn%MRBE< zmZ@&qIwdcuFVwUeGkR{mWM~zJ^ygq_(?1wk(jL`jwE4;92P9`lWIjmNZ;pu(QPTSy zl#@g#r2k_JcV zT70gGf7^9BceM5@pa0DR&Ms4E<|jAqwTkPVELz$|a<8_hI;$$C);H5%evTp+YH+)b z9RKO~)WKfR=M{+kekd0@3V(ZAzFtv_`t1t|N4Zn_NSXe?%9k6=i^Q!pihIL1@nIx+ zA0;x(=X+H(2qu)DJlM%!<}2&>Q`ET=sl~n^8`mH>3wjtsDR~kdaR@`@8h0^=N(xBzFp9vdD+7Ag;WW)&+~E}`NMm0C=|>uAJZ2fBQXOL zuIn8DkN-{Nc$sJaHBM|W5601nT^Ih*%F>iL_bVgkgVex}8kaw8aoE;Z=-+HR9UMhr zTPK_xefOrN-jHLyG-AY)b`_5$HGvg02NxKTC5rM~TUe-E&tZcWm_crd%)Wu@9dUVl zc`;n@y=^mLp$unPwN>U2c%ryiHku;?v2-pBAmB5eBc>v{P!J>yXy!nEFlor8{@m@` zwDx3~UEX|eT@^}rwRQSc_MaEvm@cPNj5@iF^wUQ)0k6-7z3ylvQ}1acYi;x>&+!!; z$@N&9>6^s4$B=NJbjtwD;B1+gM|Wp!fSrfBYRu7p87v?0UnIC?k16O&Zz z&pByPRpp9!Vg_=kwob*+2$w!Xm(kPe=a4@lffr{47-2^ z(A63a5kvp#?xdrIEhe*8`aQQ8hd65y$kHIyf$$G8q8vlDajch)^W-z0RxZzvR zRb#Z%=X6HSaeSP}6;5UI;uK(Gk+auh8q3rpHC0@@!=+y_(?u4;7J>J&6b0(r4tyBd z3YUqCy2sInvX*smqV_B4a_ED#wa?ojh$t!JP&vQ40gaF;r6XcKK*|!fqZonxbH=!7 z1Dr9yAA=lz9oyqprqT-x-iVN|abF7uaB4c34xYKvT+MuLe@UdGh`rkcHUFw;=-1s~Msh@C8duS5}VEhYfRS zX}(fIN1zf;ZGciE$o@+7wx+s%W!JIc614{XK%zfFV#>fp^@$q*^xKa@AyI0WS;-px zW)osBb?u9)TGM7(8FS9)Re;e33TkRPn>qRuyGN-X+qm6AzjLdnr`)x=vM+!erLvKa zd_!)0AKrCUwJ6?n6@(T?3A`6iG@hBk(qJc{mx_}HWGkA?lre~sc%bBnt^vQTHRu$f zC~?iTLLpp{!BTk?sQdiRg%hb$AVKukVpIvRbNh@67lU&c?n$LC6xnivkm6_n_e-YbMcIrmiItzZd1q$kGwpOtXgob4Ix|+rEyPpV z_;UoZCLo7B><>s8Ch*Ub0HkEDF(@EpN=h=!cRF)`ZI=wdq@K~&ugu9tfCAeoT;Xm# z4snY+EAMSooBAAygAblfz6}^TW_mh0x#d3HCvB*srE!|k!xcXBNrFb(UD?Rz` z7yeIo?-*TK*RX3=tV+eUZQHhO+g7Dw+qNsVZQHi(RPTD;=lf3MoF4t7|8(c)9xEej z%#pR%oY%bWdr~mhB&BPOS?7_jilY>H3y<1X-6|)dty!z96aJp6Ts@-skg!-0L@Nsy z?R$6h@j<(jd7{p6Q8AGz_Hr|?qj4o60zy#{H1y27NNv}$<%9v&hQ4i+IQT^qU8M0u zP2^o}AzE2FNRsp67|5(kG4SfbP);S>kyRuPcV760s{n4Bb5m!-S<}MWjQsBYz1Ia#fm{b4G#=f5;UDVetmpTpoJwhdkP_G7s0D?K;576+iFD=xRY zjceb#_6W1Ibyh?-@Fx=U&9=0vo$v7kcDc(Sa3xK8N~qoyWCBIzFBaA^rRS#$ifB>J zQ@HaWHd$jk>*7I+uZXp)b*L$b;?wHUx9)| z5UT!jGm(Bgh>HT$?=AD&4_<{U(>iiITm}hPi#y72UbB;=gHi?e)~<O8lWZ?i+&u;mhvksyGH zu^G&KjlrKTp^zUxeh6n*gt?`fPNX{Q_5~eXvs7<1Am)hf8Z^%p-yF+j`8{8{wOV%} zd<4x?r-s^@VuiLw-7LkFFu_cUPg7U+d=#DCu!Ldl0Iv6ZS2FQX(Tar7-o$m_(?UWW zgmArx5cnl&`%>nML>}{PIo-SW^3KJJhg2zfG8sx}Xt_-X7ax;WH5&v<<@MM2;M0Xk z#_F0hwS3c4C^xpUt}ap5(60dS4IY}!HO><%448#C#9T#S&%D`M0%QN*1Linh7Aj#g zgsFkDi^a-wf|v}MCF2oMehl+r=%){%4`ERH7p2rTZ{%CwWANcC>&oG&;@Ucau^bBE zxL6;c$Dyf~i(nsGG~EYShGu`Fkv}4?6F7&4BLa^`^M^Z;?LhcMgE|N@7IO>a0OazI z&H3*0*Xe95wT;lv?bS)X?(&uFhDR+EuGRr!0a^{Fs&!D9FKqZ4iOyb9 zRnzvl<%({DdouK=Ed+4vi3WOkQ$zF;*5p*I`gt&Y9^V?h++3>I+M#8?QsK-t z_jSFS$#SZMfmh%eXO;$wi$4EbzXEL8jA=0(ftTVF(EGywUHix2*(4|^*)u&kg=nEe zwfgRev=~?Gc8+xmkaiOnnN6mnj1NI7di>o2{@aE`3<6wc=N8R8wj-{dV-Cg~*7;_S z4-q*cfnb3h=ez^ML!?vmvB2MBHyTdN0p(skUsNug!j@IYY%UM#CYzi;|?E zAJH;$U!Oyj6g&WRTj1`*gu?S6r`sXt(0E@VhCrf0QZ_dpG}EC_G<-elcq-fHHt5gG zotjj&MveaFTlMwEZ9S-Fj@obSR)CPrJ>Q}7r@=DYBb)hb-c&}an+4~Ov|DPr-%O-o z3n=B_b_AaG_oC^VhUiU;zec>C2~*v6$A2Vxs|yiLUvcT?qNf5ENl7uqd z?-hNdih{!J<;|r##{wlFWZYa%Nzo+u#&1??s}VqM36|7_y26tDf}&GrcisiF=zU0= ztDPz!6XJqHB3*wM(WY54t|7v0ox?R;yONG3A6+0UTF+yCCPt;iEIh%Gh3sy?t470H zp1Wx6NU}M;-FT?S4;=Gqf5y)=U`%fbxLx)VuVJ?fM-zUxpSGRzx^C90#YhNo`CK^{ za=6Ln49}%ZfszXB&cd?s+&Z?kPDG2DSy`nlTQvm;-jG-FqgMwbzJe{%kSu|E3M|(& zlX-@1$vAHZOW3PCUG{&ojiIonPINcVe5J9fpj5kUhDfR4k|&%@P5!OGUaJwEFZ0T}{afJ} zqKCYpyI7L08lvO*S48Fr||1;YECa zvO;`F`%JP9W9RalUHw$NDI^*T;er7X`2jemL32oTqi=;V zA4k?ZHb6sbL`BtzW_}7wE;X_7_&vMa)|ie}F!e-hs)K@jbWsKK!B`*x$$Kl{OPjMy z%H-C<=$V9jt3VMBkmWX8N=iX>)8=|mRFOkRUs zhvQ4Y%qD~b6rROmtT2Pu1u13U!Q)^cY~qXW;hpb}$l+dxjjq*hl$*%uY^&x2yl{6) ze9%@|izg)X16%yLcN{Mr>puq`m*%=2Ns z6tNG+I5qY5@+>||L@j3eT8@b(d=0n0gKAa&>bJKv%bvn{u{2OXUh_Cgjet_I(n8#V zsJNge>o}6Hg=iQj>9}!y>+*$RcMGI#dvf5(z|~Qdt5Yu zj&z~J0$W*d7wzc{@@p~u@CFYm$M$^OZ&{d}=^cNLnaoZs^dhp4P8nYP*6_4a`{4xA*8RK6~BQ59|2@*u_eH zby^flTLAC|fKCdq6H|9(@ywGm@2v$n`H(IJ2s7|D8z(6|N!>v<3}`1I`YSf(8dA`H zk`+u0EmEy~7z2%kNSg_S5~AL>|IGodYIAL2(PQXU+$})7p`H7ElZN-~aF2)wDxUFg z%x6HumBMKK*G+`{QTju(^RA+{L}NrQ4TtETJy5s-l5e`B5J*tEWrW;R=_Z8M%K0bEsDGEhz(4+)j9>9|8?fj1 z0GDw++Y8)xSzTW-3CJOT@8VpLbbm*y?v>ZX0(8C)e6oWJX|+b?Q|;5Ovdd^K)57j+ zIpbJ1o6GC2Qnn>l8$ z2EGg>bZBtFfN;1}8yS$+(q@sbSE$BlDB`b6OXL&xRu(>{<_F)9lv`A<@FY{h(!w&K zUQhv`@IQmCD_2+Ol698F@s6@;0vLHvr*E{??3-GeuR2OI5L37&p(J-q7Y)p{;K!nncXo4~)ym-h$Tz zc{T5W{YuER9>a6WKd)+9PPAyFwx12#R^0`>AOo>Z0B zAh}t_#Bnb=OE=+^<}qRYCnJWZOY%!h7S(ImQejFMl+KaYbSh>EWD^~rm`tLp^XFkp z)^9dZ(jZ5mR?7W>!|@Lr%(7qHa#=R}iOBtXQl@%9EVFcqYO2Gu81$tG4%nYhF*?zG zKZ)%~n-5~+70~!#AdCFkjItHneI@!_)}1K`yiOz@L_~4}Pd&i`4Kg{=8HRTMz24k4 z_(;h^qkdtqD*MTUbU{EP- z5@+a9k_en6DS*<`l?^AZb_qVwST#L3Fm^5->}F}MrctwWO|j|ql(E)2ayAtRQ}rEA zaI#EsX+!$?>dexXxo5}8TJWQ$!q;jh5>op4C^^L$%*gNW_Os$cqoZQSe<;pC%lz_U zuTh4`K1;fK!+5At`ZfyiWuIf@C;bX=Gi>=z-gXm~Qzt=!lC_`#j^UVIq5rSDJz3si zJitT2TO$vI7OI32MoP!Dz$_}9UUe)0Wzzf3f!J|J+A!YZuaj=kXrhHFD^8n+?L|ts z!m?ev;@$f4o3xb>G_Mn3l0JnWTpii102$`UdV@^u=bQr(z5oBw@Wf=Z?8rAzJSmB8 zmBX=MI;!W-i||$$BL<0-b@hBR`Nfi^6t~_7NVK} zCX`QwA@eI&k3Y~&%C>F#_{;)f-`ZwLCH@nk6N_Pe;8#0^c!D&gS2pAM6KHmP2g(OQT;J{h83Kos8C~jeW8N<*gS7S zNKJ7O0cYEoDcp+!Ms`Qo8j&JW?A+hQM-zz}agwfq!U7}WZ7!{-{C90W`GUlm69-zcY+zPFj51HX)NmT*>{#2uFK3FQ#s^P1n6$PFJu&-bV}AE9 zlWgVg*4u4v{vTp%gcwH5nY&s+#O2}C2Yq#mc7Xca7`*Civ37US2+>;NnhdBZ$pBk` zE`euS>@;5XqV`iZLH&fGf`W4qDB9c&bgx7LzsqZA4Yj-P-hCSA0oYeR)fE3#dF*;J zm$gX&9m=p*F!~!l_(srH9PqL~`mdV1yB!JE;A*erKzYI+proK~fZUHi;|N^f^VaP% z@jxx%;ei%ekrD+^gp=$Vwr{vgjv^+9{Xw>0iU`!HJy}EmJcy9%GUy%`@u+xVJq2vg zBRsBs9-RQK3=@tNlA_3md@IhVp-=Ld6si8$J>FBpBGx^a?V%v^10y>H-izoPt zzFWkaON=G=NpLr-ffp>g2S`AdK9rah!ZxFAUA+dByf1IU*lPc*dWR=@ zXwUh$+S52{iW;7qPK=6#rikTQ(Q~u{nll73S~0BC-T;t@gv5 z{vDsTpIZYpeP1wYp!w?VDJ%zBFmy;P!&s^1%BaZ4Z7Ul#ZPkxqGghESLw8O|Bt)4a zh*SeeI%s*YB26!tc_R`lVHLh1@@=%uckP1o;gkmXVxsW2-&Z19^Vgf2Q)mvuKO#b- zwQ}xXElc!kscES7*cLRB;!gD_#TPS*r2N1BMRSOx|4-1Ij%e-w63r3FTJ5Gq9Fpge zY3M5wvwIZN2~f!GQzw%$my6&dM#Ur4)tG`Xwcj-FkTsxA+{%(~>8^-$$ zul|oSocbBaFN9eh^@IW~`VT@c^RwT^hq^L@f!OPilJUf~CZph`<9=Pop@wCLFPRa-h@*H_9Z(d@K@N0tQ_GmvABa>A6CwrL6rPWcvO265yX$hA z2R)aRqDmgU_cw?mDh$IX;^@#(Ik4ieHj&#ZH3R{R40VIu^s@iKH2g^aqif2gXYd2o zJUgqmeqBX(+q+9wvB1Yse&2@2j+Sj#3!)qe$3!^p%<3v+HrjamKw9R z4(h6QY4<*o>qZeT9YfQmZ8D=lN5Rq!tg$PO9!YU#@gDfD{6_zGDAX4&I4>I^4dJx$Y>)vi< z+<+h>ps?^qgTEJC&9Ui^HZM>u{56icu{x@M?DAWufz`dK-kJIoky|l@mgl~)i-fE*zOsF)Bd8;y5QoQW97Kk%K0eS3MxtPq+U38st}9ed2+RBFbbx$GwJUJ2X4@ z2Ic}45eqnNYFwkbx<=}m8MX`PxnRfY0x0Y({_F@n5si6`TNjk*19brmMGiu^->Cb$ z1hb+lxfBK@KSgK?WFn)tbT;uTedD(w7MR__fdqw7N^yFUN;%C}{T#*+W!8#=+!0Mgz+a!zf4Kzp)wdxwQnv#hUB` z4e)yV0E$t*U>RRYD0l!xm+Gvdv19*KmH_OhiQ#BCtQI#?d!~@EfGzQ7=EuvaI8k_P zKx(z>Cuyx3-j9Qy2pklIQAF`Syz|Te8c+@<bP3bDdD`z+bIyJ|&``y>{c4laab zxPl;q=hyIgC!_5n>6P@#jD$BuN~pay_8qpQ964y}seIYXRQ-YvYdzKmhuoO7|3J%$ z;~iC4E`)U^@>(zx*j41h8StyMk`;Fu8vveKUhggamkU5Yg-`=MNquBgkHrICm%0&oB z2K|?y7Lo&4Fa>AL0?of@7XferfYU%ONiX2H|FU0-Z~zMq|3U5YPZ$6oZw&xwGB$&` z#D9#n!2c(=ARXGdbNe5(D+d4nFSLsY+HEwS;MdJyB{^MT=L-)Nqdq2FPIX8o97=4H z3iUhkAHZvnnqSIE0FMVuVe1Bf08fKxU;E>FG@Yiszg*6{yPSrn5zT#cTOAMY4#)4M z?^QqN%RP=f=Dta1u+V%iIe##18d!b_Foo|TmLmHBI%63UdHd%$T}uXQo9O+LCP%V= z{6``G-|JeK>KHjz!@t*vd<@f5!bE@pwF}f$9*3le5mf>2uQx=Z8t1wDpCTNX`D7U9MZN)` zuyErA;P_xpsDJXl<$!=JAna@D-NNwbS;*w=Y#~VS_sg}G+x4Of&9|0o_u=&U-M|6R zG3E2vU76jekJ@b^o5gwR0Po(hI5E~S&O>;EoQi5Kbdc~V25l>5t$6$+O z+}U*L^kQ+1wo9MM!2g|jGsOPSe6HuoJ}xxR4ct@bA#PJQ$F2j5sRDfc13dHiElCo%Jh5R(=?`h4C$8aoUwPo^^~Ff zQ3wAphQsvJh=1y$fA5TPnH~?qr_q$^<6j>aIOl+lch{N0qfYXkRC-_@H^sJBX-02O zT&n}9RtL18lavzKX|cEhp`*!Zw9I54W)huY!9Btn1%0PTsJL!hfPN~!R3cb~gktHo zQzbSB4%`$m+02oPKSJGqi1-lMwq5Sy-;*bp7)!2T$L;true1xRyI(yE&Gh)NPH*}F z(is9-_uA~H5q&E0uW^b%r)og*Gf=s?IdAmvS?hA#T~-;&kRhkSMNH<qWZG9_}S-aWq%5{dg+Y?ak z92agvJ=)W~4-u2YmYKq6Bwdqo`+ris%;`@@jY!oV_bUT?^`WTHrI7p?4P1)8f06Qjh# zK?D?LeyEc`Wtfpk($Ky~gidUL?RC98&&0!1f8Q7nAAdr#SYC4cc)r~2!DRQ=x!jp{ zB^02jllmCL?y$w*3oiEYQK+=T8+>j5SEVb0f9O5ao=F|y`;m_iddR( zgBf(o@+QV;?&25thWIyjMB!KrlR$9JAD!Iv`9WuQ{NMSX>_A;9&hl;ld@hui!pl8GR7~OfSSQhX;N->k~^86~7VvzJEt}E3X zU(}t@c~pfkB^4>Wd6S$lnRTKs*|pSh%R>v;-}z0RAwgt;kfDz?or+7er@k-ujKeuG zsZWu2u2AX?n;_e$`MixFAqI@YWq31!%$>ka(oLHg`B+49_oFa_zd*vn$H+zmlId~l z2?WRIw2$9NX#joOMM%h6)J8lWGUsW_T@-qWnY+14{d@`*sUQA(2(6g0xe2@U;E$$e zJei(^pSirkHheQor5u{X+fT*8=DX_6(g}B-6_#gB`$-WD6zejJ7?ltl(;m~ZesQ275Ci9zA`7A#t+8l$Q3d3a zNT9ZP9%R2EwHx(b$Mo{P#aOvrKwfMw&?4Emzn9pVP4a#4OMDoxRNB9doc?Nu`K1Tr zdv`1ck0kQhcEagR)*heo91(;Q zH5Xh zX~Mr?natG+X3*QyoH+?k#d9A^lHto9i8_6fM=c@|5s`(2NO{Le{$yH_ ztFLYxt>wcuc2Z4;mmfck2Ta*a{U5T6>Om4>SQ6t32}W4J>Zz6bKxGT(yg2V~|`9s2AE?@^s* zEOhaw2`^biFXn^S@8sfy^Q@c|#t5h9fcH*2U0*S6_SmlneAJ_imASRxPL&+3+ZJ-t zc_DcCT!rJ6521Qzw}dl^L-#tnbfH=p2{Q!!DzOs6`7hzH-1s`N{Gz6t7To7gxwkAv zX3mW5XwcpoPiMc7M_~pH@q8T%>~=y6iTtziI0TWn&0HL|ca_2-l>;LQ9v`D?qCjiE zLSpRq4+|QFq!3+&02bp-5s%3T#QqU#hkKbt14x)cmJ1`Mu`-UGHN9v6Rurs_M zzg_hhRXBiin8rkrV$2VGzobeD^M zEe*)?$B5USTBYr2flbS#(UHR4$rY%sP1I*P;hVKND9U3#d%I`n zbH~89kXZj65^WuHKJ<$!KG#39!~B z)Ej^YsfiY&5Wh?tPM ziOAN|?F7dQoIbS@8CE#KFeqWqe zB--Y!GaXNVoP8{?iyHF7?7rXPs&(0ZdA&8_V|TrzbXeD1mE~aF7xK1(gYqmJigl&u z4zI-TP|xsgInd(zK}z$ea@97|>`&2*Iw5Z9B8@BYK|B#2{dQ=NO1qt`$&+Lq@@;cV z*2;rD*W74tVq)mj7t+(!@k=~turXGm|9-sOFr`6ib(k*>aAlzdh z{jSH$_@m8YK?Vz9;~$I{KE@l#`=83%9Tb|)AO@iulbi><2Z8qMTN}5vCIqrmDxjz> zm)d}-{=^Xbs>^^Ze`rS6=h}LPTkH+4cT-&PNOkugD|8WT!)}5<+ixMhoX$RboUY>P zIK*XcDbqTl9;cFs7nv>Wy{@wKjalMCGd4aySvNvVSJ9ITX3UZkm6N?!oOV*v&^Db7 z=H>|5h6CsF$6}2P1&WkQ5QU)PH7EQ!{C~oAZ6BaJytm;6g=dE;E&P2k>GB$-$+~)F zv#r9$S-T=YCrN=A*TZbi;S7O7byj9VL}9NP%SuHDj7LAvd>6A76Hcd)O6E{7-VXEM zNB%LnY*iMm%A&KG%)pqW`5bNN6jQT`6ZJTx<4FCGQ& z$W}=h&CP?W3!+oq(0KZ#X(R;cX@Xc?kPTk35iQvC=6Diu9his{=S)oRs2p>;ppkY_ zo^-)iXTyN%7g$-Ad&_i@CO@p>5UBRb19_i&8)*4Jp~LU1g^}jiX3$4GLDPbVuto`@ z>~_x&JJ7SInIM;Kl}sN#g?mAQ7=99>q1Xwdu`!CrJJQO$SMR<3Wa+;QY0>xczbTqCUh)%dlwG2#|e7M@O&F+MBsM!T6#C=WSPu zZ;(<*X*=Bf?~1W{<#b6$g`JtSNRCw}VHrYmJ8;mz3LZZye<>Cj-GRGj`>U-9ZC6*B zTRz~*42T_mT8AmcY2vV9f6qF?U2_BS48+nRRAh{cE)n(Vn&baj*(mpXoX(ZRf_)}Uq$;r}D zNt2uevCK0*iN%-1DD;h2TSzut2}XN z(P!9Ge_{j{sbvVqpL>ir;khs>0tq7{i+nTsL#n|hxRqNFsYDDt%W*17K^B?yBHU53 zth&){gDQFX-(FMn^STLfij0CL_W^vfd zGsuHymF|*+ZvJdhG?XDlldRtAZu#_n2s_M#(5NB3)uR>QvT)+fh8 z&%BOwPkzI1NY*|-Y2Io`fMNUysiEO$yqnBjd@|h~EDYnynpIUv5$^-IV6Mbo<=+XN zkXb}(x*Ijhw@{$=Pl>K2DymjMI;nnO>P5ucppDSndU!;K ziW9~m1a;ie;XSx8!@ap)&UQ1z2a)J9o~>zKP&t>6uaq3#@~<~5-aSdY84!B)95G?a z6%+Z!lYE`O-Q-_~_!DV*Gh|H z{f|DGYMa_K5Tp|*^|T+uSKKWyboSa8jzYCz9ofT%VB-IipC2C|zU35>`orTmDj1y= zv0m;0m?xIXk}O;$Z*(}^VD?*4v+3JTokN*g*(4o>j@ z*-KtLD${_l__o4wx`$%i6kT5oWIu>8J|7vB_l9e$+JII8hgnulg?s)xE~x>Kkn0?q z5x@yh^COj{(?7aBJFQn4R}^M$9=%tOQffUI6;S^fEnxrFfS$d@3bkn*i=!;!n)DZU zR4?30cYCGH;t)3;ZC$mi>L)+j`Qzm6+K;(EI&b#z6YK^WY}aerk8~={H0_rgGp+C4 z-hb5od{%TlcJY0j!QI&zZ6C0u?%7O#t#9*bcz2z<6=Zw3L2bZf(s;cU`K{@AuFqtc z@!D@&7L(iAUPl+??$Nm8*bf-E0-mJcS9h1Af(Z|u&y0_SDXFDa(T`a%Je_V|pCmh# zLq4_Nnw{Zc&CY{!`4AB|$L}zD&u;Ak!AkT+FI`W)ELGk?iB(5gs~5#@$v8kUrW19m z%5`>rTFdmBlXqkpG!zuunrKj-o$1_RPj*eP<{|Z@h(e^B?aiy0u#V?T!F8+dV*TSF z*pc<5$1>NUK!Z~8vL!=^wJSSeadBmOTq<|~Wh#bYx_BSQ>zHKWd#OjE!Wl^_QZw=^<+x2g^ZSNEZJ=bBz z#Ij56rtn0*j(kvn*jN;&AUXlP>P*RzTpSYgrJtK`k@MV>-INfij|$x)Rgr;7)qx9{ zAYR&s4F39iyom<~su1pyhnq1%wVb@Bw&mWZ0(V@96N;e9Y$qugNcRj&eG1H&)$15y zs3Mlw1Lkv!e^B;gbsZ`@ATN`~x3Vm6?)-Mggf=de$_%D6NCdnOgMA{%;Z54c{is4= z9?jGedt)PBX`h=-YgM~0gS@6DO9>ROULtimO3ubO_)Jz-u*_X|}7` zricDeg_IV40u2&XVv{y?k~nNw3x$Sn!_@T0t#`}|$wY0qZ4bz%!*@0qc&A==lzhQ7)nO22<4dNoN^=CJXM}Kz(X)T$mJJBBVX{Ra6L?HfQtvP{;)A8yR32Fc#&QIYVMnv1h}d@#FDG@kmcO( zZnR@=eD-W(RM)y;br~_kOx&fi?;A7I$WhbhLB~v6f4-y{G7)%Jg}LJ<--y;D>OqbB zOSm;Ph+(6mJYXO9;33^bWt*;Su4K$2`r4aNGIGs=5N~Z*;q|#Nv)LFjRVR-mKDp;g zTRo(v63)4e48uK+k@JM#0PdiWc|sH4yxUOt?3>tfzw}&v&Y$yXrn>kL$s4z)msO}~ z(254So$R>6Jmg}(jdvf1)p=?}ieX`++9@P(xneBLuJgLh=_PP)z+tAQE=%J%hvO#g z-FjHLbIO+}THSECs717k|Hx06xskpWPELXKD=9FwO+~B# zh;Ogk_~LY6HhaZ@G7km6wX-14HkCNLs@=6x!phRiN5_Q!2WvsKP!;F4yThu{Y^Y`5GCi6z> zT>|3cz=M%A1jQ3|>OEk2mbYi8_fo*m2BlE-KK4bfJsBbTHkgydeM~3KQ0a93qNlBE zz~QI%?C%as)?sG1L*}LC)V>dH$20O>pI@~{ySK)}Qq>NtHS~_#q1-i&-lf;gwfnN+j51udm8sqV&1C*{(ecY$E_kHG2lX2 zxSEc;7uRCd_M%$2$N3Yl&s##>RxkwpyDPWNd)HsP%p^|h*DLWfF+Tq2dADxS-M8KF z8Qd35eDu7$4_frt_wEtDVuZ(%iTzwePjv*2$n0df8%WUAU9trS^yyyjkmBBl{NC&J zw0(B$Sdoji!(k&8$$7P&%x8v!q2BJ^(5&!oqs#zGtu-X~*I=WffI#nym)(rEHW)@{ zAf9-}d3WdjZvJh(&v1K8H$&4%GXeaXefO_cK)HP<*B;RJ=jH4)*%KC5sU|Z_^z`k47JvVsZNXpejm$ zFgl~EVzzgbAIb#RtNO<9kb}nSLo+=O$@aVYgY-A3=dGv;=0DIZc?kf`f}<w8A#ifGd-?* z=G}A?&o0wCp~RB!!aOuBWQ+<(=lBsWArAA@OiUEKRaap#gDq)PFocQ3m1M8V=Y@d{ z)Sw7Lic1qq?=1t*2JEE0>w4A45kGrGUFe@NE`)IH43!9#W)^2U1pm&QCts25C#jn& zh*m^>M@@sDy=9d$3TRiZOfK6=%v{41VNOYwXn|a{&XYqDva(X0^IYDa(BrDoVH_$6ejE-9yn3H|X(2axd%E|L z_^cL6A-;3X4;C2~ef2-C>zEaCQijvcQrFX*dds7;$KB6$3_7yhuu9B`vt(|vJYpx8 zy=p>hRu~U|SR?a&05u0x$#+$BYx$TwjKy7J*Vbmm^GYaYD_vP{uu@J_ zsCmUXCSn^a(XMd`YLqcd;D;7rBxhPQsOQ;vDXrXG6~mev?<}%PTUwaIN|^wEP-Tl2 zC*Pg0VT5EUZ3&(n4DBljmQb?Y@nt-|>DRG1947RaAf}DkyIX0HLG|t04sc74Im4X^ z^>O1hTGQrvsy^qW#AcDxt}A0wJ{m5H5hQaUz9t=VMfUyH-{SJST;Y%EESamBPh^w9 zt0*nCG{1X#?BMI=lQw))XA;tS_Ggs8uPpDd|dPi{@&M zm{jyz;clRfhvtmJ^0EWbpv0I4`RI6!zv4VG(^SPjpqA0=qpUS%$x`~cr8!|KTos@ZgYmNJDz2& zH`#oBKUUzPb=oC20CTGn;cG?1Y7rbP6_Z?KiFG_jJtuCM~4Y zCKtUlMZuCc)Z%&w_Bg^``Y^jJ%A~B7TVLO+!ejbNqCNBS^<6s2=PM<{SbYgbul{*c z9u;sRkZNW)@xj52eB;F<*={w%T1%{C$vJAa(`HiH{VK3!ohP$YVpc7-4h6G|#Q;ta z3utB-?<0b-3rl3A319h0>Sp>NEyp!WY2{y@qL3D7MHxf-sJ==U zpn>*#fI}T+LZEYO3Mu+ftqi;KqWqd~n~Iusa$2Hs5P!$$L98A+r6}OyVTpO{?SYOl ztC8caQ*;|poFGQc4(1*E2C(q6uNXeia$Pr7EU3O*=hl&W1 zzHG}Yb7eR2W=0K0tfM?BpVUsGm*0aQ>Y|nYNMq)q?PL(zAp1pXQ{+o~o^*Zd)Q}BTBNsUYJ`|7pHU|5Xvg*$I-2y7=GmJzkxyQ+??cDjyhU6B$eVO-lpA7HM*8YoE z`D5A4vXC_kS$7<~-cWU=z8FDG-E~A(kyDWL9&)DX40;O{PquuaFB1{JKQDVc&w$Ed zaIl?}>SQziI{+7@F?uX=Q{Ogi#>_Gn5YJN=YGVpkW%iCY>kVPR8bC6TAGp>@BG2qM zF|z0c@e!o#js=famsa)Fed5wm5QWHB$aBu|sqYRFa-dm#h898-Z}xk{-p{-KU>mP9AR5f*n?7J&H1ph9V%_ zxSolf*#sLqa!jRO1@5bnf3$NBF1+T@owD=fPwOmT>{LLTRG8QT_KL>$lMgb|l66V} zV<#=}nTl`w&3ND`!-Js9a!cC~ag^UmH+0{MnMrZyea^Z$CEg4yL>8h;Ufa@I9 zQvxkCGG1FXUQN*MD?D6YX5O_->`tO2wjtiGTN*t5L?Moe9P~GOR33hbswfBwZvh9} z%qg73O{%rbF;9AEj3j_*va=^+#{(1a!;>lCKRDe*gN ze@lh&0_6SrpNFQ(YH>zo#a zBBx=wnIaYC$fU?-Y05{QW&F@{n#^pGU+q{h)DRRU*`mnj(;ZC2_AR{}NJDb?(tz;Z zU-Qb^Je(A1Mt3x1eKliY~r}lYB~DzW@TnNyJ)Byn}g(xXhgXcdf@n7_2rldy@6e?me} z%&DZ|vFN7?Oi>pAloGBg5)>ZCMrCrQYbjx6&?6l47XP$AmT<6qIZ2BgN;nP8A%@P| zdN?~*CXXQAbQc^QVd-_MJbo4GGCS+zvOHD2?u2lBF2ywW%F|m_g`%?z4697z97{vT z#4x9gd^!`zqCM5MDT4Llyr$(6&?9&9h|hN9rDYj&D70Mwe93~(Le@rT&CO6g&qQGs zBvnbWSLoSx2V;tT6SzK#7oa&!i2Yaqa%RjJ0|3v$ri<^87O`o#o~*VT=AMGeZNlFa z+I3nXXygp~?7yoDY@#ez^qURCWALAi?heBUPo{E7tz4yO$+ zvnLWH9%ulhbb1Y^GYnjR0bMw*MQ6L5a3${?{CYY(!hX$fdIU4$CMENNwg*HB%kE8tnhC^{a^nZsecwZ literal 0 HcmV?d00001 diff --git a/docs/en/Tutorials/images/bookstore-efcore-migration.png b/docs/en/Tutorials/images/bookstore-efcore-migration.png new file mode 100644 index 0000000000000000000000000000000000000000..9714e795e205576cbbdc66ffebf4d9322b379024 GIT binary patch literal 30521 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�?0jvAW}L+ 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 tLS9G5kdcuY)hwaND*g9Lx5B&rDrq{_ NuGet包管理器*下的**程序包管理控制台 (PMC)**. +启动模板使用[EF Core Code First Migrations](https://docs.microsoft.com/zh-cn/ef/core/managing-schemas/migrations/)创建和维护数据库架构. 我们应该创建一个新的迁移并且应用到数据库. -![Open Package Manager Console](images/bookstore-open-package-manager-console.png) - -选择 `Acme.BookStore.EntityFrameworkCore.DbMigrations` 做为**默认项目**然后执行以下命令: +在 `Acme.BookStore.EntityFrameworkCore.DbMigrations` 目录打开命令行终端输入以下命令: ```bash -Add-Migration "Created_Book_Entity" +dotnet ef migrations add Created_Book_Entity ``` -![bookstore-pmc-add-book-migration](./images/bookstore-pmc-add-book-migration-v2.png) - -它会在 `Acme.BookStore.EntityFrameworkCore.DbMigrations` 项目中的 `Migrations` 文件内创建一个新的迁移类. +它会添加新迁移类到项目中: -在更新数据库之前,请阅读下面的部分了解如何将一些初始数据插入到数据库. +![bookstore-efcore-migration](./images/bookstore-efcore-migration.png) -> 如果你使用其他IDE而不是Visual Studio, 你可以使用 [`dotnet-ef`](https://docs.microsoft.com/zh-cn/ef/core/managing-schemas/migrations/?tabs=dotnet-core-cli#create-a-migration) 工具. +> 如果你使用Visual Studio, 你也许想要在*包管理控制台(PMC)*中使用 `Add-Migration Created_Book_Entity -c BookStoreMigrationsDbContext` 和 `Update-Database -c BookStoreMigrationsDbContext` 命令. 确保 {{if UI=="MVC"}}`Acme.BookStore.Web`{{else if UI=="BlazorServer"}}`Acme.BookStore.Blazor`{{else if UI=="Blazor" || UI=="NG"}}`Acme.BookStore.HttpApi.Host`{{end}} 是启动项目并且 `Acme.BookStore.EntityFrameworkCore.DbMigrations` 是 PMC 的*默认项目*. {{end}} diff --git a/docs/zh-Hans/Tutorials/images/bookstore-efcore-migration.png b/docs/zh-Hans/Tutorials/images/bookstore-efcore-migration.png new file mode 100644 index 0000000000000000000000000000000000000000..9714e795e205576cbbdc66ffebf4d9322b379024 GIT binary patch literal 30521 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�?0jvAW}L+ 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 tLS9G5kdcuY)hwaND*g9Lx5B&rDrq{_ Date: Fri, 21 May 2021 13:52:18 +0300 Subject: [PATCH 2/4] Revised the CMS kit documents --- docs/en/Modules/Cms-Kit/Blogging.md | 48 ++++++++++++-- docs/en/Modules/Cms-Kit/Comments.md | 73 +++++++++++---------- docs/en/Modules/Cms-Kit/Index.md | 94 +--------------------------- docs/en/Modules/Cms-Kit/Pages.md | 26 +++++++- docs/en/Modules/Cms-Kit/Ratings.md | 48 ++++++-------- docs/en/Modules/Cms-Kit/Reactions.md | 56 +++++++---------- docs/en/Modules/Cms-Kit/Tags.md | 88 ++++++++++++++------------ 7 files changed, 198 insertions(+), 235 deletions(-) diff --git a/docs/en/Modules/Cms-Kit/Blogging.md b/docs/en/Modules/Cms-Kit/Blogging.md index db067ef5ec..8f7690ffdb 100644 --- a/docs/en/Modules/Cms-Kit/Blogging.md +++ b/docs/en/Modules/Cms-Kit/Blogging.md @@ -2,15 +2,51 @@ The blogging feature provides the necessary UI to manage and render blogs and blog posts. -## Internals +## User Interface -Menu Items +### Menu Items The following menu items are added by the blogging feature to the admin application: * **Blogs**: Blog management page. * **Blog Posts**: Blog post management page. +## Pages + +### Blogs + +Blogs page is used to create and manage blogs in your system. + +![blogs-page](../../images/cmskit-module-blogs-page.png) + +A screenshot from the new blog creation modal: + +![blogs-edit](../../images/cmskit-module-blogs-edit.png) + +**Slug** is the URL part of the blog. For this example, the root URL of the blog becomes *https://your-domain.com/blogs/technical-blog/*. + +#### Blog Features + +Blog feature uses some of the other CMS Kit features. You can enable or disable the features by clicking the features action for a blog. + +![blogs-feature-action](../../images/cmskit-module-blogs-feature-action.png) + +You can select/deselect the desired features for blog posts. + +![features-dialog](D:\Github\abp\docs\en\images\cmskit-module-features-dialog.png) + +### Blog Post Management + +When you create blogs, you can manage blog posts on this page. + +![blog-posts-page](D:\Github\abp\docs\en\images\cmskit-module-blog-posts-page.png) + +You can create and edit an existing blog post on this page. If you enable specific features such as tags, you can set tags for the blog post on this page. + +![blog-post-edit](D:\Github\abp\docs\en\images\cmskit-module-blog-post-edit.png) + +## Internals + ### Domain Layer #### Aggregates @@ -33,9 +69,9 @@ This module follows the [Repository Best Practices & Conventions](https://docs.a This module follows the [Domain Services Best Practices & Conventions](https://docs.abp.io/en/abp/latest/Best-Practices/Domain-Services) guide. -- `BlogManager`: Includes some operations for `Blog` aggregate root to keep data consistency. -- `BlogPostManager`: Includes some operations for `BlogPost` aggregate root such as creating & updating. -- `BlogFeatureManager`: Includes some operations for managing blog features. +- `BlogManager` +- `BlogPostManager` +- `BlogFeatureManager` ### Application layer @@ -43,7 +79,7 @@ This module follows the [Domain Services Best Practices & Conventions](https://d ##### Common -- `BlogFeatureAppService` _(implements I`BlogFeatureAppService`)_ +- `BlogFeatureAppService` _(implements `IBlogFeatureAppService`)_ ##### Admin diff --git a/docs/en/Modules/Cms-Kit/Comments.md b/docs/en/Modules/Cms-Kit/Comments.md index 542be54c59..e5a5da592e 100644 --- a/docs/en/Modules/Cms-Kit/Comments.md +++ b/docs/en/Modules/Cms-Kit/Comments.md @@ -1,23 +1,10 @@ -# Comment System +# CMS Kit: Comments -CMS kit provides a **comment** system to add comments feature to any kind of resource, like blog posts, products, etc. This section describes the details of the comments system. +CMS kit provides a **comment** system to add comments feature to any kind of resource, like blog posts, products, etc. -## Feature +## Options -CMS kit uses the [global feature](https://docs.abp.io/en/abp/latest/Global-Features) system for all implemented features. Commercial startup templates come with all the CMS kit related features are enabled by default, if you create the solution with public website option. If you're installing the CMS kit manually or want to enable the comment feature individually, open the `GlobalFeatureConfigurator` class in the `Domain.Shared` project and place the following code to the `Configure ` method. - -```csharp -GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit => -{ - cmsKit.Comments.Enable(); -}); -``` - -# Options - -## CmsKitCommentOptions - -You can use the comment system to add comments to any kind of resources, like blog posts, products etc. Comment system provides a mechanism to group comment definitions by entity types. For example, if you want to use comment system for blog posts and products, you need to define two entity types named `BlogPosts` and `Product`, and add comments under these entity types. +The comment system provides a mechanism to group comment definitions by entity types. For example, if you want to use comment system for blog posts and products, you need to define two entity types named `BlogPosts` and `Product`, and add comments under these entity types. `CmsKitCommentOptions` can be configured in the domain layer, in the `ConfigureServices` method of your [module](https://docs.abp.io/en/abp/latest/Module-Development-Basics). Example: @@ -38,9 +25,43 @@ Configure(options => - `EntityType`: Name of the entity type. -# Internals +## The Comments Widget + +The comment system provides a commenting [widget](../../UI/AspNetCore/Widgets.md) to allow users to send comments to resources on public websites. You can simply place the widget on a page like below. + +```csharp +@await Component.InvokeAsync(typeof(CommentingViewComponent), new +{ + entityType = "Product", + entityId = "..." +}) +``` + +`entityType` was explained in the previous section. `entityId` should be the unique id of the product, in this example. If you have a Product entity, you can use its Id here. + +## User Interface + +### Menu Items -## Domain Layer +The following menu items are added by the commenting feature to the admin application: + +* **Comments**: Opens the comment management page. + +### Pages + +#### Comment Management + +You can view and manage comments on this page. + +![comment-page](../../images/cmskit-module-comment-page.png) + +You can also view and manage replies on this page. + +![comments-detail](../../images/cmskit-module-comments-detail.png) + +## Internals + +### Domain Layer #### Aggregates @@ -101,17 +122,3 @@ See the [connection strings](https://docs.abp.io/en/abp/latest/Connection-String - **CmsComments** -### MVC UI - -The comment system provides a commenting widget to allow users to send comments to resources on public websites. You can simply place the widget on a page like below. - -```csharp -@await Component.InvokeAsync(typeof(CommentingViewComponent), new -{ - entityType = "entityType", - entityId = "entityId" -}) -``` -You need to specify entity type and entity ID parameters. Entity type represents the group name you specified while defining the comments in the domain module. Entity ID represents the unique identifier for the resource that users send comments to, such as blog post ID or product ID. - -For more information about widgets see [widgets](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Widgets) documentation. diff --git a/docs/en/Modules/Cms-Kit/Index.md b/docs/en/Modules/Cms-Kit/Index.md index 0db9f172c8..fbdc37ec18 100644 --- a/docs/en/Modules/Cms-Kit/Index.md +++ b/docs/en/Modules/Cms-Kit/Index.md @@ -2,7 +2,7 @@ This module provides CMS (Content Management System) capabilities for your application. It provides **core building blocks** and fully working **sub-systems** to create your own website with CMS features enabled, or use the building blocks in your web sites with any purpose. -> **This module currently available only for the MVC UI**. While there is no official Blazor package, it can also work in a Blazor Server UI since a Blazor Server UI application is actually a hybrid application that runs within the MVC UI. +> **This module currently available only for the MVC / Razor Pages UI**. While there is no official Blazor package, it can also work in a Blazor Server UI since a Blazor Server UI is actually a hybrid application that runs in an ASP.NET Core MVC / Razor Pages application. The following features are currently available: @@ -55,98 +55,6 @@ CMS kit packages are designed for various usage scenarios. If you check the [CMS - `Volo.CmsKit.Public.*` packages contain the functionalities used in public websites where users read blog posts or leave comments. - `Volo.CmsKit.*` (without Admin/Public suffix) packages are called as unified packages. Unified packages are shortcuts for adding Admin & Public packages (of the related layer) separately. If you have a single application for administration and public web site, you can use these packages. -## The User Interface - -### Menu items - -CMS Kit module admin side adds the following items to the main menu, under the *CMS* menu item: - -* **Pages**: Page management page. -* **Tags**: Tag management page. -* **Comments**: Comment management page. - -`CmsKitAdminMenus` class has the constants for the menu item names. - -### Pages - -### Page Management - -Pages page is used to manage dynamic pages in the system. - -![pages-page](../../images/cmskit-module-pages-page.png) - -You can create or edit an existing page on this page. - -![pages-edit](../../images/cmskit-module-pages-edit.png) - -* When you create a page, you can access the created page via `pages/{slug}` URL. - -### Blog Management - -Blogs page is used to create and manage blogs in your system. - -![blogs-page](../../images/cmskit-module-blogs-page.png) - -A screenshot from the new blog creation modal: - -![blogs-edit](../../images/cmskit-module-blogs-edit.png) - -#### Blog Features - -You can enable or disable a specific feature for blogs by clicking the features action. - -![blogs-feature-action](../../images/cmskit-module-blogs-feature-action.png) - -You can select/deselect the desired features for blog posts. - -![features-dialog](../../images/cmskit-module-features-dialog.png) - -### Blog Post Management - -When you create blogs, you can manage blog posts on this page. - -![blog-posts-page](../../images/cmskit-module-blog-posts-page.png) - -You can create and edit an existing blog post on this page. If you enable specific features such as tags, you can set tags for the blog post on this page. - -![blog-post-edit](../../images/cmskit-module-blog-post-edit.png) - -### Tag Management - -CMS Kit provides an extensible tagging mechanism to add tagging capabilities to various places. - -![tags-page](../../images/cmskit-module-tags-page.png) - -You can create or edit an existing tag on this page. - -![tag-edit](../../images/cmskit-module-tag-edit.png) - -### Comment Management - -CMS Kit provides an extensible commenting mechanism to add comments to various places. You can add comment control to anywhere you want and manage the comments. - -You can view and manage comments on this page. - -![comment-page](../../images/cmskit-module-comment-page.png) - -You can manage and view replies on this page. - -![comments-detail](../../images/cmskit-module-comments-detail.png) - -### Reactions - -CMS Kit provides an extensible reaction component system to allow users to send reactions to your content. Here how the reactions component looks on a sample page. - -![reactions](../../images/cmskit-module-reactions.png) - -You can also customize the reaction icons shown in the reaction component. - -### Ratings - -You can use the rating component to add rating a mechanism to your content. Here how the rating component looks on a sample page. - -![ratings](../../images/cmskit-module-ratings.png) - ## Internals ### Table / collection prefix & schema diff --git a/docs/en/Modules/Cms-Kit/Pages.md b/docs/en/Modules/Cms-Kit/Pages.md index 33336f21d6..b508621f49 100644 --- a/docs/en/Modules/Cms-Kit/Pages.md +++ b/docs/en/Modules/Cms-Kit/Pages.md @@ -1,3 +1,27 @@ # CMS Kit: Pages -This document is in progress... \ No newline at end of file +CMS Kit Page system allows you to create dynamic pages by specifying URLs, which is the fundamental feature of a CMS. + +## The User Interface + +### Menu items + +CMS Kit module admin side adds the following items to the main menu, under the *CMS* menu item: + +* **Pages**: Page management page. + +`CmsKitAdminMenus` class has the constants for the menu item names. + +### Pages + +#### Page Management + +Pages page is used to manage dynamic pages in the system. + +![pages-page](D:\Github\abp\docs\en\images\cmskit-module-pages-page.png) + +You can create or edit an existing page on this page. + +![pages-edit](D:\Github\abp\docs\en\images\cmskit-module-pages-edit.png) + +When you create a page, you can access the created page via `/pages/{slug}` URL. \ No newline at end of file diff --git a/docs/en/Modules/Cms-Kit/Ratings.md b/docs/en/Modules/Cms-Kit/Ratings.md index 76aaaaa249..7e7d3a0ca3 100644 --- a/docs/en/Modules/Cms-Kit/Ratings.md +++ b/docs/en/Modules/Cms-Kit/Ratings.md @@ -1,23 +1,12 @@ # Rating System -CMS kit provides a **rating** system to to add ratings feature to any kind of resource like blog posts, comments, etc. This section describes the details of the rating system. +CMS kit provides a **rating** system to to add ratings feature to any kind of resource like blog posts, comments, etc. Here how the rating component looks like on a sample page: -## Feature +![ratings](../../images/cmskit-module-ratings.png) -CMS kit uses the [global feature](https://docs.abp.io/en/abp/latest/Global-Features) system for all implemented features. Commercial startup templates come with all the CMS kit related features are enabled by default, if you create the solution with the public website option. If you're installing the CMS kit manually or want to enable the rating feature individually, open the `GlobalFeatureConfigurator` class in the `Domain.Shared` project and place the following code to the `Configure ` method. +## Options -```csharp -GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit => -{ - cmsKit.Ratings.Enable(); -}); -``` - -# Options - -## CmsKitRatingOptions - -You can use the rating system to to add ratings to any kind of resource, like blog posts, comments, etc. The rating system provides a mechanism to group ratings by entity types. For example, if you want to use the rating system for products, you need to define an entity type named `Product` and then add ratings under the defined entity type. +The rating system provides a mechanism to group ratings by entity types. For example, if you want to use the rating system for products, you need to define an entity type named `Product` and then add ratings under the defined entity type. `CmsKitRatingOptions` can be configured in the domain layer, in the `ConfigureServices` method of your [module](https://docs.abp.io/en/abp/latest/Module-Development-Basics). Example: @@ -38,6 +27,20 @@ Configure(options => - `EntityType`: Name of the entity type. +## MVC UI + +The ratings system provides a rating widget to allow users send ratings to resources in public websites. You can simply place the widget on a page like below. + +```csharp +@await Component.InvokeAsync(typeof(RatingViewComponent), new +{ + entityType = "Product", + entityId = "entityId" +}) +``` + +`entityType` was explained in the previous section. `entityId` should be the unique id of the product, in this example. If you have a Product entity, you can use its Id here. + # Internals ## Domain Layer @@ -99,18 +102,3 @@ See the [connection strings](https://docs.abp.io/en/abp/latest/Connection-String ##### Collections - **CmsRatings** - -### MVC UI - -The ratings system provides a rating widget to allow users send ratings to resources in public websites. You can simply place the widget on a page like below. - -```csharp -@await Component.InvokeAsync(typeof(RatingViewComponent), new -{ - entityType = "entityType", - entityId = "entityId" -}) -``` -You need to specify entity type and entity ID parameters. Entity type represents the group name you specified while defining the reactions in the domain module. Entity ID represents the unique identifier for the resource that users give ratings to, such as blog post ID or product ID. - -For more information about widgets see [widgets](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Widgets) documentation. \ No newline at end of file diff --git a/docs/en/Modules/Cms-Kit/Reactions.md b/docs/en/Modules/Cms-Kit/Reactions.md index e1219e24c3..86da9ccb72 100644 --- a/docs/en/Modules/Cms-Kit/Reactions.md +++ b/docs/en/Modules/Cms-Kit/Reactions.md @@ -1,23 +1,16 @@ # Reaction System -CMS kit provides a **reaction** system to add reactions feature to any kind of resource, like blog posts or comments. This section describes the details of the reaction system. +CMS kit provides a **reaction** system to add reactions feature to any kind of resource, like blog posts or comments. -## Feature +Reaction component allows users to react to your content via pre-defined icons/emojis. Here how the reactions component may looks like: -CMS kit uses the [global feature](https://docs.abp.io/en/abp/latest/Global-Features) system for all implemented features. Commercial startup templates come with all the CMS kit related features are enabled by default, if you create the solution with the public website option. If you're installing the CMS kit manually or want to enable reaction feature individually, open the `GlobalFeatureConfigurator` class in the `Domain.Shared` project and place the following code to the `Configure ` method. +![reactions](../../images/cmskit-module-reactions.png) -```csharp -GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit => -{ - cmsKit.Reactions.Enable(); -}); -``` - -# Options +You can also customize the reaction icons shown in the reaction component. -## CmsKitReactionOptions +## Options -You can use the reaction system to to add reactions feature to any kind of resource, like blog posts or comments, etc. The reaction system provides a mechanism to group reactions by entity types. For example, if you want to use the reaction system for products, you need to define an entity type named `Product`, and then add reactions under the defined entity type. +Reaction system provides a mechanism to group reactions by entity types. For example, if you want to use the reaction system for products, you need to define an entity type named `Product`, and then add reactions under the defined entity type. `CmsKitReactionOptions` can be configured in the domain layer, in the `ConfigureServices` method of your [module](https://docs.abp.io/en/abp/latest/Module-Development-Basics). Example: @@ -39,16 +32,30 @@ Configure(options => }); ``` -> If you're using the comment or blog features, the ABP framework defines predefined reactions for these features automatically. You can easily override or remove the predefined reactions in `Configure` method like shown above. +> If you're using the comment or blog features, the ABP framework defines predefined reactions for these features automatically. `CmsKitReactionOptions` properties: -- `EntityTypes`: List of defined entity types(`CmsKitReactionOptions`) in the reaction system. +- `EntityTypes`: List of defined entity types (`CmsKitReactionOptions`) in the reaction system. -`ReactionEntityTypeDefinition` properties:asdas +`ReactionEntityTypeDefinition` properties: - `EntityType`: Name of the entity type. -- `Reactions`: List of defined reactions(`ReactionDefinition`) in the entity type. +- `Reactions`: List of defined reactions (`ReactionDefinition`) in the entity type. + +## The Reactions Widget + +The reaction system provides a reaction widget to allow users to send reactions to resources. You can place the widget on a page like below: + +```csharp +@await Component.InvokeAsync(typeof(ReactionSelectionViewComponent), new +{ + entityType = "Product", + entityId = "..." +}) +``` + +`entityType` was explained in the previous section. `entityId` should be the unique id of the product, in this example. If you have a Product entity, you can use its Id here. # Internals @@ -111,18 +118,3 @@ See the [connection strings](https://docs.abp.io/en/abp/latest/Connection-String ##### Collections - **CmsUserReactions** - -### MVC UI - -The reaction system provides a reaction widget to allow users to send reactions to resources on public websites. You can place the widget on a page like below. - -```csharp -@await Component.InvokeAsync(typeof(ReactionSelectionViewComponent), new -{ - entityType = "entityType", - entityId = "entityId" -}) -``` -You need to specify entity type and entity ID parameters. Entity type represents the group name you specified while defining the reactions in the domain module. Entity ID represents the unique identifier for the resource that users give reactions to, such as blog post ID or product ID. - -For more information about widgets see [widgets](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Widgets) documentation. \ No newline at end of file diff --git a/docs/en/Modules/Cms-Kit/Tags.md b/docs/en/Modules/Cms-Kit/Tags.md index aa4b675dac..17bc5cf47f 100644 --- a/docs/en/Modules/Cms-Kit/Tags.md +++ b/docs/en/Modules/Cms-Kit/Tags.md @@ -1,25 +1,14 @@ # Tag Management -CMS kit provides a **tag** system to tag any kind of resources, like blog posts. This section describes the details of the tag system. +CMS kit provides a **tag** system to tag any kind of resources, like a blog post. -## Feature +## Options -CMS kit uses the [global feature](https://docs.abp.io/en/abp/latest/Global-Features) system for all implemented features. Commercial startup templates come with all the CMS kit related features are enabled by default, if you create the solution with public website option. If you're installing the CMS kit manually or want to enable the tag management feature individually, open the `GlobalFeatureConfigurator` class in the `Domain.Shared` project and place the following code to the `Configure ` method. +The tag system provides a mechanism to group tags by entity types. For example, if you want to use the tag system for blog posts and products, you need to define two entity types named `BlogPosts` and `Product` and add tags under these entity types. -```csharp -GlobalFeatureManager.Instance.Modules.CmsKit(cmsKit => -{ - cmsKit.Tags.Enable(); -}); -``` - -# Options +`CmsKitTagOptions` can be configured in the domain layer, in the `ConfigureServices` method of your [module](https://docs.abp.io/en/abp/latest/Module-Development-Basics) class. -## CmsKitTagOptions - -You can use the tag system to tag any kind of resources, like blog posts, products, etc. The tag system provides a mechanism to group tags by entity types. For example, if you want to use the tag system for blog posts and products, you need to define two entity types named `BlogPosts` and `Product` and add tags under these entity types. - -`CmsKitTagOptions` can be configured in the domain layer, in the `ConfigureServices` method of your [module](https://docs.abp.io/en/abp/latest/Module-Development-Basics). Example: +**Example: Adding tagging support for products** ```csharp Configure(options => @@ -28,7 +17,7 @@ Configure(options => }); ``` -> If you're using the blog feature, the ABP framework defines an entity type for the blog feature automatically. You can easily override or remove the predefined entity types in `Configure` method like shown above. +> If you're using the blog feature, the ABP framework defines an entity type for the blog feature automatically. `CmsKitTagOptions` properties: @@ -38,13 +27,47 @@ Configure(options => - `EntityType`: Name of the entity type. - `DisplayName`: Display name of the entity type. You can use a user friendly display name to show entity type definition on the admin website. -- `CreatePolicies`: List of policy names allowing users to create tags under the entity type. -- `UpdatePolicies`: List of policy names allowing users to update tags under the entity type. -- `DeletePolicies`: List of policy names allowing users to delete tags under the entity type. +- `CreatePolicies`: List of policy/permission names allowing users to create tags under the entity type. +- `UpdatePolicies`: List of policy/permission names allowing users to update tags under the entity type. +- `DeletePolicies`: List of policy/permission names allowing users to delete tags under the entity type. + +## The Tag Widget + +The tag system provides a tag [widget](../../UI/AspNetCore/Widgets.md) to display associated tags of a resource that was configured for tagging. You can simply place the widget on a page like below: + +```csharp +@await Component.InvokeAsync(typeof(TagViewComponent), new +{ + entityType = "Product", + entityId = "..." +}) +``` + +`entityType` was explained in the previous section. `entityId` should be the unique id of the product, in this example. If you have a Product entity, you can use its Id here. + +## User Interface + +### Menu Items -# Internals +The following menu items are added by the tagging feature to the admin application: -## Domain Layer +* **Tags**: Opens the tag management page. + +### Pages + +#### Tag Management + +This page can be used to create, edit and delete tags for the entity types. + +![tags-page](../../images/cmskit-module-tags-page.png) + +You can create or edit an existing tag on this page. + +![tag-edit](../../images/cmskit-module-tag-edit.png) + +## Internals + +### Domain Layer #### Aggregates @@ -87,9 +110,9 @@ This module follows the [Domain Services Best Practices & Conventions](https://d #### Application services -- `TagAdminAppService` (implements `ITagAdminAppService`): Implements the use cases of tag management. -- `EntityTagAdminAppService` (implements `IEntityTagAdminAppService`): Implements the use cases of entity tag relationship. -- `TagAppService` (implements `ITagAppService`): Implements the use cases of entity tag relationship for public websites. +- `TagAdminAppService` (implements `ITagAdminAppService`). +- `EntityTagAdminAppService` (implements `IEntityTagAdminAppService`). +- `TagAppService` (implements `ITagAppService`). ### Database providers @@ -111,7 +134,6 @@ See the [connection strings](https://docs.abp.io/en/abp/latest/Connection-String - CmsTags - CmsEntityTags - - CmsTags #### MongoDB @@ -119,17 +141,3 @@ See the [connection strings](https://docs.abp.io/en/abp/latest/Connection-String - **CmsTags** - **CmsEntityTags** - -### MVC UI - -The tag system provides a tag widget to display associated tags of the resource on public websites. You can simply place the widget on a page like below. - -```csharp -@await Component.InvokeAsync(typeof(TagViewComponent), new -{ - entityType = "entityType", - entityId = "entityId" -}) -``` - -For more information about widgets see [widgets](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Widgets) documentation. \ No newline at end of file From cb7b91188968df77083438e078c67d611ec652b0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Halil=20=C4=B0brahim=20Kalkan?= Date: Fri, 21 May 2021 13:57:44 +0300 Subject: [PATCH 3/4] Update Blogging.md --- docs/en/Modules/Cms-Kit/Blogging.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/en/Modules/Cms-Kit/Blogging.md b/docs/en/Modules/Cms-Kit/Blogging.md index 8f7690ffdb..43ab85e129 100644 --- a/docs/en/Modules/Cms-Kit/Blogging.md +++ b/docs/en/Modules/Cms-Kit/Blogging.md @@ -33,17 +33,17 @@ Blog feature uses some of the other CMS Kit features. You can enable or disable You can select/deselect the desired features for blog posts. -![features-dialog](D:\Github\abp\docs\en\images\cmskit-module-features-dialog.png) +![features-dialog](../../images/cmskit-module-features-dialog.png) ### Blog Post Management When you create blogs, you can manage blog posts on this page. -![blog-posts-page](D:\Github\abp\docs\en\images\cmskit-module-blog-posts-page.png) +![blog-posts-page](../../images/cmskit-module-blog-posts-page.png) You can create and edit an existing blog post on this page. If you enable specific features such as tags, you can set tags for the blog post on this page. -![blog-post-edit](D:\Github\abp\docs\en\images\cmskit-module-blog-post-edit.png) +![blog-post-edit](../../images/cmskit-module-blog-post-edit.png) ## Internals From 26de4343a27119ad768f1e2f0573b47db44ba50e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Halil=20=C4=B0brahim=20Kalkan?= Date: Fri, 21 May 2021 13:59:12 +0300 Subject: [PATCH 4/4] Fixed images --- docs/en/Modules/Cms-Kit/Pages.md | 7 ++++--- docs/en/Modules/Cms-Kit/Ratings.md | 4 ++-- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/en/Modules/Cms-Kit/Pages.md b/docs/en/Modules/Cms-Kit/Pages.md index b508621f49..7945bfd5ff 100644 --- a/docs/en/Modules/Cms-Kit/Pages.md +++ b/docs/en/Modules/Cms-Kit/Pages.md @@ -18,10 +18,11 @@ CMS Kit module admin side adds the following items to the main menu, under the * Pages page is used to manage dynamic pages in the system. -![pages-page](D:\Github\abp\docs\en\images\cmskit-module-pages-page.png) +![pages-page](../../images/cmskit-module-pages-page.png) You can create or edit an existing page on this page. -![pages-edit](D:\Github\abp\docs\en\images\cmskit-module-pages-edit.png) +![pages-edit](../../images/cmskit-module-pages-edit.png) + +When you create a page, you can access the created page via `/pages/{slug}` URL. -When you create a page, you can access the created page via `/pages/{slug}` URL. \ No newline at end of file diff --git a/docs/en/Modules/Cms-Kit/Ratings.md b/docs/en/Modules/Cms-Kit/Ratings.md index 7e7d3a0ca3..8702feb24e 100644 --- a/docs/en/Modules/Cms-Kit/Ratings.md +++ b/docs/en/Modules/Cms-Kit/Ratings.md @@ -27,7 +27,7 @@ Configure(options => - `EntityType`: Name of the entity type. -## MVC UI +## The Rating Widget The ratings system provides a rating widget to allow users send ratings to resources in public websites. You can simply place the widget on a page like below. @@ -101,4 +101,4 @@ See the [connection strings](https://docs.abp.io/en/abp/latest/Connection-String ##### Collections -- **CmsRatings** +- **CmsRatings** \ No newline at end of file