canonicalwebteam.blog 2.4.1

Flask extension and Django App to add a nice blog to your website

Blog flask extension

This extension allows you to add a simple blog frontend to your flask app. All the articles are pulled from the WordPress API that has the plugin WP-JSON.

This extension provides a blueprint with 3 routes:

• "/": that returns the list of articles
• "/": the article page
• "/feed": provides a RSS feed for the page.

How to use

Flask

In your app you can:

    import canonicalwebteam.blog_extension import BlogExtension
    blog = BlogExtension(app, "Blog title", [1], "tag_name", "/url-prefix")

If you use the factory pattern you can also:

    import canonicalwebteam.blog_extension import BlogExtension
    blog = BlogExtension()
    blog.init_app(app, "Blog title", [1], "tag_name", "/url-prefix")

Django

• Add the blog module as a dependency to your Django project
• Load it at the desired path (f.e. "/blog") in the urls.py file

from django.urls import path, include
urlpatterns = [path(r"blog/", include("canonicalwebteam.blog.django.urls"))]

• In your Django project settings (settings.py) you have to specify the following parameters:

BLOG_CONFIG = {
    # the id for tags that should be fetched for this blog
    "TAGS_ID": [3184],
    # the title of the blog
    "BLOG_TITLE": "TITLE OF THE BLOG",
    # the tag name for generating a feed
    "TAG_NAME": "TAG NAME FOR GENERATING A FEED",
}

• Run your project and verify that the blog is displaying at the path you specified (f.e. '/blog')

Groups pages

• Group pages are optional and can be enabled by using the view canonicalwebteam.blog.django.views.group. The view takes the group slug to fetch data for and a template path to load the correct template from. Group pages can be filtered by category, by adding a category=CATEGORY_NAME query parameter to the URL (e.g. http://localhost:8080/blog/cloud-and-server?category=articles).

from canonicalwebteam.blog.django.views import group

urlpatterns = [
    url(r"blog", include("canonicalwebteam.blog.django.urls")),
    url(
        r"blog/cloud-and-server",
        group,
        {
            "slug": "cloud-and-server",
            "template_path": "blog/cloud-and-server.html"
        }
    )

Topic pages

• Topic pages are optional as well and can be enabled by using the view canonicalwebteam.blog.django.views.topic. The view takes the topic slug to fetch data for and a template path to load the correct template from.

urls.py

path(
		r"blog/topics/kubernetes",
		topic,
		{"slug": "kubernetes", "template_path": "blog/kubernetes.html"},
		name="topic",
),

Templates

• You can now use the data from the blog. To display it the module expects templates at blog/index.html, blog/article.html, blog/blog-card.html, blog/archives.html, blog/upcoming.html and blog/author.html. Inspiration can be found at https://github.com/canonical-websites/jp.ubuntu.com/tree/master/templates/blog.

Development

The blog extension leverages poetry for dependency management.

Regenerate setup.py

poetry install
poetry run poetry-setup

Testing

All tests can be run with poetry run pytest.

Regenerating Fixtures

All API calls are caught with VCR and saved as fixtures in the fixtures directory. If the API updates, all fixtures can easily be updated by just removing the fixtures directory and rerunning the tests.

To do this run rm -rf fixtures && poetry run pytest.