How-to guides

How-to guides#

These guides solve one task each, for a project that already runs Plone.

๐Ÿ“ฆ Install the package

Add the dependency, and load the ZCML with or without autoinclude.

Install the package
โš™๏ธ Configure Redis

Point Plone at Redis, and run Redis as a private, bounded cache.

Configure Redis for a deployment
๐Ÿ” Use Valkey

Swap Redis for Valkey without changing the URL scheme.

Use Valkey instead of Redis
๐ŸŽฏ Include and exclude functions

Choose which cached functions may use Redis.

Include and exclude functions
โฑ๏ธ Give a function its own TTL

Cache a function of your add-on for a lifetime of its own.

Give a function its own TTL
๐Ÿงน Invalidate after a deploy

Drop values that new code computes differently.

Invalidate cached values after a deploy
๐Ÿ“Š Monitor the cache

Read the status endpoint, the counters, and the logs.

Monitor the cache
๐Ÿงช Test your add-on

Run your add-on's tests against a fake Redis.

Test your add-on against Redis
๐Ÿฉบ Troubleshoot

Find the cause of the most common problems.

Troubleshoot