How halo-dev/halo works
Halo is a website-building and CMS platform for blogs, knowledge bases, and business sites. Its principal product workflow is managing content in the console and presenting public pages through themes; the tree also shows separate capabilities for comments, search, authentication, attachments, plugins, and extensions. The excerpts substantiate some service-level relationships, but not the full console-to-server request flow or most subsystem wiring, so those links are omitted rather than inferred.
Main entry points: CommentPublicQueryServiceImpl.java Public comment queries · OAuth2RegistrationService.java OAuth registration · PostPublicQueryService.java Public post queries · LuceneSearchEngine.java Search engine
Components 23
Content management
- Admin console
ui/console-src/main.ts - Post services
application/src/main/java/run/halo/app/content/impl/PostServiceImpl.java - Page services
application/src/main/java/run/halo/app/content/impl/SinglePageServiceImpl.java - Comment services
application/src/main/java/run/halo/app/content/comment/CommentServiceImpl.java - Post model
api/src/main/java/run/halo/app/core/extension/content/Post.java - Comment model
api/src/main/java/run/halo/app/core/extension/content/Comment.java
Public site
- Public post queries
application/src/main/java/run/halo/app/theme/finders/PostPublicQueryService.java - Public comment queries
application/src/main/java/run/halo/app/theme/finders/impl/CommentPublicQueryServiceImpl.java - Comment view model
application/src/main/java/run/halo/app/theme/finders/vo/CommentVo.java - Theme rendering
application/src/main/java/run/halo/app/theme/TemplateEngineManager.java - Post content handling
api/src/main/java/run/halo/app/content/PostContentService.java
Extension platform
- Extension API
api/src/main/java/run/halo/app/extension/AbstractExtension.java - Extension controllers
api/src/main/java/run/halo/app/extension/controller/Controller.java - Indexed queries
api/src/main/java/run/halo/app/extension/index/IndexedQueryEngine.java - Plugin management
application/src/main/java/run/halo/app/plugin/PluginService.java
Identity and access
- Authentication providers
application/src/main/java/run/halo/app/security/AuthProviderService.java - OAuth registration
application/src/main/java/run/halo/app/security/authentication/oauth2/OAuth2RegistrationService.java - User management
api/src/main/java/run/halo/app/core/user/service/UserService.java
Site capabilities
- Search service
api/src/main/java/run/halo/app/search/SearchService.java - Search engine
application/src/main/java/run/halo/app/search/lucene/LuceneSearchEngine.java - Attachment service
api/src/main/java/run/halo/app/core/extension/service/AttachmentService.java - Themes and plugins
application/src/main/java/run/halo/app/plugin/PluginService.java
Other components
- Site administrator
Connections 9
- Site administrator → Admin console: manages site
- Public post queries → Post content handling: loads content
application/src/main/java/run/halo/app/theme/finders/PostPublicQueryService.java - Public comment queries → Comment view model: converts to
application/src/main/java/run/halo/app/theme/finders/impl/CommentPublicQueryServiceImpl.java - Public comment queries → Comment services: queries comments
- Public comment queries → Comment model: maps comments
application/src/main/java/run/halo/app/theme/finders/impl/CommentPublicQueryServiceImpl.java - OAuth registration → User management: creates users
application/src/main/java/run/halo/app/security/authentication/oauth2/OAuth2RegistrationService.java - OAuth registration → Extension API: uses client
application/src/main/java/run/halo/app/security/authentication/oauth2/OAuth2RegistrationService.java - Search engine → Search service: implements contract
application/src/main/java/run/halo/app/search/lucene/LuceneSearchEngine.java - Themes and plugins → Plugin management: manages plugins