Search
Meerkat

Meerkat

Installation and Upgrade Guide

To install Meerkat into a Statamic 4 project using Composer, simply run the following command at the root of your project:

1composer require stillat/meerkat

#Upgrading to Meerkat 3

Upgrading your site from Meerkat 2 to Meerkat 3 should be relatively painless for most sites. However, please note the following major changes and considerations:

  • The Antlers Regex (legacy) engine is no longer supported by Meerkat,
  • If your site design utilizes recursive comments please make sure to run at least Statamic 4.13.0, which adds Antlers support for arbitrary recursive arrays.
  • The RecursiveThreadRenderer from Meerkat 1 and 2 have been removed in favor of Antlers Runtime features,
  • Internal telemetry and error reporting features have been completely removed in favor of GitHub issues
  • Threads will no longer be automatically created when a visitor views a page with the {{ meerkat:responses }} tag (they will be created if they submit a comment)

There have been no changes to the data structure, and your existing comment data can be migrated as-is. Minimal UI changes have been made to reduce friction.

#Double Check Your Installation

The following directories should have been created automatically for you during the installation:

1config/
2├── meerkat/
3content/
4├── comments/
5storage/
6├── meerkat/
7| ├── index/
8| ├── logs/
9| ├── tasks/
10| ├── tmp/

Meerkat also creates a new blueprint for you automatically at /resources/blueprints/meerkat.yaml; this should appear automatically for you in the Control Panel when navigating to Fields > Blueprints. It will appear in the "Other" table (or whatever table appears last on that page).

Some absolutely amazing
people

The following amazing people help support this site and my open source projects ♥️
If you're interesting in supporting my work and want to show up on this list, check out my GitHub Sponsors Profile.