You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
abp/docs/en/Modules/Cms-Kit/Blogging.md

115 lines
3.1 KiB

# CMS Kit: Blogging
The blogging feature provides the necessary UI to manage and render blogs and blog posts.
## User Interface
### 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](../../images/cmskit-module-features-dialog-2.png)
##### Quick Navigation Bar In Blog Post
If you enable "Quick navigation bar in blog posts", it will enabled scroll index as seen below.
![scroll-index](../../images/cmskit-module-features-scroll-index.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)
## Internals
### Domain Layer
#### Aggregates
This module follows the [Entity Best Practices & Conventions](https://docs.abp.io/en/abp/latest/Best-Practices/Entities) guide.
- `Blog` _(aggregate root)_: Presents blogs of application.
- `BlogPost`_(aggregate root)_: Presents blog posts in blogs.
- `BlogFeature`:_(aggregate root)_: Presents blog features enabled/disabled state. Such as reactions, ratings, comments, etc.
#### Repositories
This module follows the [Repository Best Practices & Conventions](https://docs.abp.io/en/abp/latest/Best-Practices/Repositories) guide. The following repositories are defined for this feature:
- `IBlogRepository`
- `IBlogPostRepository`
- `IBlogFeatureRepository`
#### Domain services
This module follows the [Domain Services Best Practices & Conventions](https://docs.abp.io/en/abp/latest/Best-Practices/Domain-Services) guide.
- `BlogManager`
- `BlogPostManager`
- `BlogFeatureManager`
### Application layer
#### Application Services
##### Common
- `BlogFeatureAppService` _(implements `IBlogFeatureAppService`)_
##### Admin
- `BlogAdminAppService` _(implements `IBlogAdminAppService`)_
- `BlogFeatureAdminAppService` _(implements `IBlogFeatureAdminAppService`)_
- `BlogPostAdminAppService` _(implements `IBlogPostAdminAppService`)_
##### Public
- `BlogPostPublicAppService` _(implements `IBlogPostPublicAppService`)_
### Database providers
#### Entity Framework Core
##### Tables
- CmsBlogs
- CmsBlogPosts
- CmsBlogFeatures
#### MongoDB
##### Collections
- CmsBlogs
- CmsBlogPosts
- CmsBlogFeatures