MamuzBlog
Features
- This module provides a blog based on ZF2 and Doctrine2.
- Posts are rendered by a markdown parser.
- Posts are taggable and searchable.
- Post listing is provided, same is true for tags.
- Hyperlinks to dedicated posts are secured by encrypted identities.
- Hyperlinks also ends with slugified post titles to meet SEO.
- Hyperlinks are Permalinks.
- Views are twitter-Bootstrap compatible.
Screenshot |
---|
Installation
The recommended way to install
mamuz/mamuz-blog
is through
composer by adding dependency to your composer.json
:
{
"require": {
"mamuz/mamuz-blog": "*"
}
}
After that run composer update
and enable this module for ZF2 by adding
MamuzBlog
to modules
in ./config/application.config.php
:
// ...
'modules' => array(
'MamuzBlog',
),
This module is based on DoctrineORMModule
and be sure that you have already configured database connection.
Create database tables with command line tool provided by
DoctrineORMModule
:
./vendor/bin/doctrine-module orm:schema-tool:update
Configuration
Post identity encryption for hyperlinks
Encryption is supported by hashids/hashids
and have to be configured by copy ./vendor/mamuz-blog/config/crypt.local.php.dist
to ./config/autoload/crypt.local.php
. Be sure that this file is not under version control.
The only thing you have to do is changing salt
value to any complex string.
Default configuration
Besides configuration for identity encryption this module is usable out of the box,
but you can overwrite default configuration by adding a config file in ./config/autoload
directory.
For default configuration see
module.config.php
Pagination
Listings of posts and tags includes a pagination feature, which seperates
views to a default range. Default range is overwritable by adding a config file in ./config/autoload
directory.
Posts
Post listing is provided by route blogPublishedPosts
and default range is two items.
Tags
Tag listing is provided by route blogTags
and default range is 10 items.
Creating a new Post
Create an entity in MamuzBlogPost
repository and tag it in related MamuzBlogTag
.
Admin Module to provide an interface for that is planned.
Workflow
If routing to a dedicated post found by published flag and encrypted identity is successful, post content will be responsed in a new view model rendered as markdown, otherwise it will set a 404 status code to the http response object.
Events
For the sake of simplicity Event
is used for FQN MamuzBlog\EventManager\Event
.
The following events are triggered by Event::IDENTIFIER
mamuz-blog:
Name | Constant | Description |
---|---|---|
createPaginator.pre | Event::PRE_PAGINATION_CREATE |
Before pagination creation for posts/tags listing |
createPaginator.post | Event::POST_PAGINATION_CREATE |
After pagination creation for posts/tags listing |
findPublishedPost.pre | Event::PRE_FIND_PUBLISHED_POST |
Before dedicated post retrieval |
findPublishedPost.post | Event::POST_FIND_PUBLISHED_POST |
After dedicated post retrieval |
Terminology
- Posts: Published articles about any issues which are listed chronological in a blog.
- Tag: Category to group related posts to a specific issue.
- Permalink: Human-readable and unchangeable hyperlink to a dedicated post or to a list of posts by a specific tag.