PHPackages                             needletail/needletail-craft3 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. needletail/needletail-craft3

Abandoned → [needletail/needletail-craft](/?search=needletail%2Fneedletail-craft)Craft-plugin

needletail/needletail-craft3
============================

Needletail Search and Index package for Craft CMS

v5.1.6(1mo ago)03.8k[1 PRs](https://github.com/needletail/needletail-craft/pulls)MITPHPCI failing

Since Jun 20Pushed 1mo agoCompare

[ Source](https://github.com/needletail/needletail-craft)[ Packagist](https://packagist.org/packages/needletail/needletail-craft3)[ RSS](/packages/needletail-needletail-craft3/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (6)Versions (87)Used By (0)

Needletail plugin for Craft CMS
===============================

[](#needletail-plugin-for-craft-cms)

Needletail Search and Index package for Craft 3.x

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 3 or 4

Installation
------------

[](#installation)

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

    ```
     cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
     composer require needletail/needletail-craft

    ```
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Needletail.
4.

Brought to you by [Needletail](https://needletail.io)

Custom Twig file
----------------

[](#custom-twig-file)

You can create a custom twig file to render the results. To do this, create a new file in your templates folder called `_needletail/[[BUCKET_NAME]].twig`. This file will be used to render the search results. You can use the following variables in this file:

- `entry` - The record that will be rendered

### Example:

[](#example)

```
{
   "title": "{{ entry.title }}",
   "slug": "{{ entry.slug }}",
   "url": "{{ entry.getUrl() }}",
   "date": "{{ entry.postDate|date('Y-m-d') }}",
   "author": "{{ entry.author }}"
}
```

### Testing:

[](#testing)

For easy testing you can create a new twig file in your templates folder `[[BUCKET_NAME]].json.twig` and add the following code:

```
{% set entry = craft.entries({id: [[ENTRY_ID]]}).one() %}

{% include "_needletail/[[BUCKET_NAME]].twig" %}
```

You can then call `$PRIMARY_SITE_URL/[[BUCKET_NAME]].json` in your browser to see the rendered result.

> **Note!** Make sure to replace `[[BUCKET_NAME]]` and `[[ENTRY_ID]]` with the correct values.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance90

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~32 days

Recently: every ~5 days

Total

79

Last Release

27d ago

Major Versions

v3.3.0 → v5.0.42024-11-04

v4.3.2 → v5.1.52025-01-21

v4.3.3 → v5.0.72026-01-19

v4.4.0 → v5.1.32026-03-24

v4.5.0 → v5.1.42026-03-31

### Community

Maintainers

![](https://www.gravatar.com/avatar/b0f5e9c6b1a109eb2034f86828480c3640c058f2b7d81a83c9c193f01b8cdbf2?d=identicon)[needletail](/maintainers/needletail)

---

Top Contributors

[![Edsardio](https://avatars.githubusercontent.com/u/10669035?v=4)](https://github.com/Edsardio "Edsardio (37 commits)")[![jacotijssen](https://avatars.githubusercontent.com/u/8997440?v=4)](https://github.com/jacotijssen "jacotijssen (34 commits)")[![EsdertCO](https://avatars.githubusercontent.com/u/64210927?v=4)](https://github.com/EsdertCO "EsdertCO (8 commits)")

---

Tags

cmsCraftcraftcmscraft-pluginneedletail

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/needletail-needletail-craft3/health.svg)

```
[![Health](https://phpackages.com/badges/needletail-needletail-craft3/health.svg)](https://phpackages.com/packages/needletail-needletail-craft3)
```

###  Alternatives

[nystudio107/craft-seomatic

SEOmatic facilitates modern SEO best practices & implementation for Craft CMS 5. It is a turnkey SEO system that is comprehensive, powerful, and flexible.

1741.4M46](/packages/nystudio107-craft-seomatic)[verbb/image-resizer

Resize assets when they are uploaded.

127269.1k7](/packages/verbb-image-resizer)[verbb/tablemaker

Create customizable and user-defined table fields.

40168.8k1](/packages/verbb-tablemaker)[verbb/hyper

A user-friendly links field for Craft.

24130.9k9](/packages/verbb-hyper)[verbb/social-poster

Automatically post entries to social media.

918.5k](/packages/verbb-social-poster)[acclaro/translations

Easily launch and manage multilingual Craft websites without having to copy/paste content or manually track updates.

1229.5k](/packages/acclaro-translations)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)