Skip to main content

Easily make your Wagtail StreamBlock cacheable

Project description

https://travis-ci.org/AccordBox/wagtail_cache_block.svg?branch=master

wagtail_cache_block

This project add HTML fragment cache to your StreamField block in easy way

Background

In Wagtail community, it is popular to use the HTML fragment cache at page level.

This works fine in most of the time. But what if some different page have the same block data and some DB query need be run multiple times when rendering?

In this case, it make sense to make HTML fragment cache work on block level instead of page level.

How it works

  1. cache_block is very similar with Django {% cache %} templatetag, it would pull data from block automatically and use the value to generate fragment cache key.

  2. If value in any block field (even descendants of the block) has changed, new fragment key would be generated and new HTML fragment code would be saved to Cache.

  3. cache_block would check if the page is preview mode, if the page if in preview mode, the HTML fragment cache would not be pulled from cache.

I have used it in my projects and the performance has been improved, especially for some page which contains many db query.

Quickstart

Install wagtail_cache_block:

pip install wagtail_cache_block

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'wagtail_cache_block.apps.WagtailCacheBlockConfig',
    ...
)

You can use it in StreamField for loop iteration

Here 300 is the cache timeout, page is Wagtail page instance, and block is the StreamField block.

{% load wagtailcore_tags cache_block_tags %}

{% for block in page.body %}
  {% cache_block 300 page block %}
    {% include_block block %}
  {% endcache_block %}
{% endfor %}

Or you can use it in block template (For example: StructBlock)

{% load wagtailcore_tags cache_block_tags %}

{% cache_block 300 page block %}
  <section class="{{ block.block_type }}">

    {{ block.value.heading }}
    {{ block.value.paragraph }}

  </section>
{% endcache_block %}

History

0.1.0 (2020-01-19)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wagtail_cache_block-0.1.1.tar.gz (6.8 kB view hashes)

Uploaded Source

Built Distribution

wagtail_cache_block-0.1.1-py2.py3-none-any.whl (6.4 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page