collective.blog

Blog features for Plone

Features

collective.blog adds blogging features to a Plone site.

Content Types

Installation

Add collective.blog as a dependency on your package's setup.py

    install_requires = [
        "collective.blog",
        "Plone",
        "plone.restapi",
        "setuptools",
    ],

Also, add collective.blog to your package's configure.zcml (or dependencies.zcml):

<include package="collective.blog" />

Generic Setup

To automatically enable this package when your add-on is installed, add the following line inside the package's profiles/default/metadata.xml dependencies element:

    <dependency>profile-collective.blog:default</dependency>

Source Code and Contributions

We welcome contributions to collective.blog.

You can create an issue in the issue tracker, or contact a maintainer.

• Issue Tracker
• Source Code

Development requirements

• Python 3.8 or later
• Docker

Setup

Install all development dependencies -- including Plone -- and create a new instance using:

make install

Update translations

make i18n

Format codebase

make format

Run tests

Testing of this package is done with pytest and tox.

Run all tests with:

make test

Run all tests but stop on the first error and open a pdb session:

./bin/tox -e test -- -x --pdb

Run only tests that match TestVocabAuthors:

./bin/tox -e test -- -k TestVocabAuthors

Run only tests that match TestVocabAuthors, but stop on the first error and open a pdb session:

./bin/tox -e test -- -k TestVocabAuthors -x --pdb

Credits

The development of this add-on has been kindly sponsored by German Aerospace Center (DLR) and Forschungszentrum Jülich.

Developed by kitconcept

License

The project is licensed under GPLv2.

Contributors

• Jonas Piterek [@jonaspiterek]
• Érico Andrei [@ericof]
• Timo Stollenwerk [@tisto]
• collective [info@kitconcept.com]

Changelog

1.0.0a4 (2023-11-28)

Bug fixes:

• Rename Blog fti to BlogFolder, allowing contents with id blog to be added [@ericof] #42
• Add initial blocks to auto_add_authors_container handler [@jonaspiterek] #43
• Rename blog index and metadata to blog_uid [@ericof] #48

1.0.0a3 (2023-11-24)

New features:

• Control creation of "Authors" folder via registry configuration [@ericof] #34
• Add control panel to configure Blog Settings [@ericof] #36
• Additional information returned on /@authors endpoint [@ericof] #40

Internal:

• Increase test coverage of the package [@ericof] #38

1.0.0a2 (2023-11-23)

New features:

• Initial Package Structure for Plone 6 [@jonaspiterek] #11
• Blog and Author should be listed on Plone Navigation [@jonaspiterek] #13
• Implement i18n support [@ericof] #17
• Implement collective.blog.blog_info behavior [@ericof] #20
• Disable allowing to add Author globally. Fix GS titles [@jonaspiterek] #21
• Add index and metadata for blog post and blog author, Add test for blog author [@jonaspiterek] #28
• Implement collective.blog: Add Author, collective.blog: Add Blog, collective.blog: Add Post permissions [@ericof] #30
• Create folder authors inside a blog [@jonaspiterek] #32

Documentation:

• Improve README.md [@ericof] #15

1.0a1 (2016-02-14)

• Initial release. [@pcdummy]