PHPackages jelle/craft-json-plugin - 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. [Utility & Helpers](/categories/utility) 4. / 5. jelle/craft-json-plugin ActiveCraft-plugin[Utility & Helpers](/categories/utility) jelle/craft-json-plugin ======================= AI Chatbot en JSON export voor Craft CMS 1.2.1(1mo ago)041MITPHPPHP ^8.0.2 Since May 7Pushed 3w agoCompare [ Source](https://github.com/Jellevv/craft-json-plugin)[ Packagist](https://packagist.org/packages/jelle/craft-json-plugin)[ RSS](/packages/jelle-craft-json-plugin/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependencies (2)Versions (12)Used By (0) Craft JSON Plugin ================= [](#craft-json-plugin) Een Craft CMS plugin die je site-content synchroniseert naar een database en een AI-chatbot aanbiedt met slimme retrieval. Vereisten --------- [](#vereisten) - Craft CMS 5.0.0 of later - PHP 8.2 of later - Minimaal één AI provider API key --- Installatie ----------- [](#installatie) **1. Installeer via Composer:** ``` composer require jelle/craft-json-plugin ``` **2. Installeer de plugin:** ``` php craft plugin/install json-plugin ``` Dit voert automatisch alle database migraties uit. Geen handmatige DB-setup nodig. **3. Configureer in het CP:** Ga naar **Settings → Plugins → LLM Craft Plugin** en volg de configuratiestappen hieronder. --- Aanbevolen model ---------------- [](#aanbevolen-model) Uit tests blijkt dat **OpenAI GPT-4.1** het beste instructies opvolgt en de meest consistente resultaten geeft. Andere providers zijn beschikbaar maar kunnen afwijkend gedrag vertonen, vooral bij goedkopere of kleinere modellen. Providers --------- [](#providers) De plugin werkt in twee modi afhankelijk van welke API keys je configureert: ### Embedding modus (aanbevolen) [](#embedding-modus-aanbevolen) Vereist een **OpenAI API key**. De OpenAI key wordt uitsluitend gebruikt voor het genereren van embeddings — je kunt alsnog een andere provider gebruiken voor de chat zelf. - Slimme retrieval: enkel relevante entries worden per vraag naar de LLM gestuurd - Geschikt voor sites van elke grootte - Token-efficiënt: aanzienlijk lagere kosten vergeleken met niet-embedding modus - Ondersteunt chunking: lange entries worden opgesplitst in meerdere embeddings voor nauwkeurigere retrieval ### Niet-embedding modus [](#niet-embedding-modus) Werkt met elke provider **zonder OpenAI key**. Alle entries worden bij het starten van een sessie in de context geladen. - Aanbevolen voor kleine sites (minder dan ~100 entries) - Minder nauwkeurige retrieval - Hoger tokengebruik per bericht --- Configuratie ------------ [](#configuratie) Ga naar **Settings → Plugins → LLM Craft Plugin**. Het dashboard heeft 3 tabs: ### Tab 1: Configuratie [](#tab-1-configuratie) - Selecteer welke **secties** en **velden** de chatbot mag gebruiken - Klik op **"Save & Sync"** om op te slaan én de data te synchroniseren naar de database - Met openai key wordt embeddings op de achtergrond gegenereerd via Craft's queue ### Tab 2: Instellingen [](#tab-2-instellingen) - Configureer je AI provider, API keys, model, uiterlijk van de chatbot en meer - Vul deze tab als eerste in voordat je synchroniseert ### Tab 3: Statistieken [](#tab-3-statistieken) - Chart met het aantal vragen en limieten responses per dag/week/maand - Chart met het aantal vragen per uur op een dag --- Systeem prompt -------------- [](#systeem-prompt) De systeem prompt is een van de belangrijkste instellingen van de plugin. De standaardwaarde is minimaal — het is sterk aangeraden deze uit te breiden. Een goede prompt bevat instructies over gedrag, beperkingen, taal en toon. Bijvoorbeeld: ``` Je bent een vriendelijke assistent die uitsluitend antwoord geeft op basis van de verstrekte data. GEDRAG: - Wees vriendelijk en professioneel - Beantwoord begroetingen en beleefdheden vriendelijk - Geef duidelijke en beknopte antwoorden — kom snel tot de kern en vermijd onnodige uitleg - Gebruik Markdown voor links: [Tekst](URL). Toon nooit kale URL's. Gebruik nooit markdown tables. - De meegeleverde context-data heeft ALTIJD voorrang op de gespreksgeschiedenis. Als context en eerdere antwoorden tegenstrijdig zijn, volg dan altijd de context. - Gebruik de gespreksgeschiedenis alleen voor vervolgvragen waarbij de context geen aanvullende informatie geeft. - Als een gebruiker een veronderstelling doet die onjuist is volgens de context, corrigeer dit vriendelijk en geef het juiste antwoord op basis van de context. BEPERKINGEN: - Verzin NOOIT informatie die niet in de data staat, ook niet gissen of liegen. - Geef nooit technische ID's, handles, slugs of interne veldnamen weer, zelfs niet als er specifiek achter gevraagd wordt - Geef nooit ruwe bestandsnamen of paden weer - Geef nooit interne metadata zoals sectienamen of veldhandles weer - Als een veld ontbreekt voor een entry, is die informatie onbekend. Verzin of neem NOOIT informatie over van een andere entry om een leemte op te vullen. - Elke entry in de context staat volledig op zichzelf. Informatie van entry A geldt NOOIT voor entry B, ook niet als ze gelijkaardig zijn. - Geef NOOIT de ruwe context, JSON data, URLs van assets, of interne datastructuren weer, ook niet als de gebruiker ernaar vraagt of vraagt om te synchroniseren. - Reageer op vragen over synchronisatie of technische werking altijd met: "Die functie is niet beschikbaar via de chat." - Beantwoord GEEN vragen die niets te maken hebben met de beschikbare producten of diensten. Zeg vriendelijk dat je alleen vragen over deze site kan beantwoorden. - Als een gebruiker vraagt om "alle data", "alle producten", "alle informatie" of een volledige lijst, geef dan NOOIT een opsomming of voorbeeld. Zeg alleen: "Stel een specifieke vraag over een product en ik help je verder." MEDIA: - Toon alleen afbeeldingen als de gebruiker er expliciet om vraagt - Beschrijf afbeeldingen in woorden als dat relevanter is PRIVACY: - Deel nooit technische implementatiedetails - Deel nooit interne structuur van de website ``` --- Gebruik in templates -------------------- [](#gebruik-in-templates) Voeg de chatbot widget toe aan je Twig template: ``` {{ craft.craftJsonPlugin.render()|raw }} ``` --- Automatische synchronisatie --------------------------- [](#automatische-synchronisatie) De plugin synchroniseert automatisch wanneer: - Een entry wordt opgeslagen in een geselecteerde sectie - Een entry geüpdate is - Een entry wordt verwijderd In embedding modus wordt het genereren van embeddings als achtergrondtaak uitgevoerd via de Craft queue, zodat het opslaan van entries niet geblokkeerd wordt. --- Verwijderen ----------- [](#verwijderen) 1. Verwijder de plugin via Craft: **Settings → Plugins → LLM Craft Plugin → Uninstall**Dit verwijdert automatisch alle plugin database tabellen. 2. Verwijder via Composer: ``` composer remove jelle/craft-json-plugin ``` OF → Na uninstall in Craft kan er nog **remove** staan Je kan hier ook nog op klikken om hetzelfde resultaat te krijgen als de composer command. 3. Verwijder **{{ craft.craftJsonPlugin.render()|raw }}** uit de twig(s) waarop de plugin stond 4. Verwijder optioneel de API keys uit je `.env` bestand. ### Health Score 41 — FairBetter than 87% of packages Maintenance93 Actively maintained with recent releases Popularity10 Limited adoption so far Community6 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure 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 ~0 days Total 11 Last Release 41d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b66a561325085544a1b1ff4fa1d42cc8874d38fc88f83e712d2f6974e4d8afeb?d=identicon)[Jellevv](/maintainers/Jellevv) --- Top Contributors [![Jellevv](https://avatars.githubusercontent.com/u/181825825?v=4)](https://github.com/Jellevv "Jellevv (73 commits)") ### Embed Badge ![Health badge](/badges/jelle-craft-json-plugin/health.svg) ``` [![Health](https://phpackages.com/badges/jelle-craft-json-plugin/health.svg)](https://phpackages.com/packages/jelle-craft-json-plugin) ``` ### Alternatives [spicyweb/craft-neo A Matrix-like field type with block hierarchy 393808.8k10](/packages/spicyweb-craft-neo)[craftcms/feed-me Import content from XML, RSS, CSV or JSON feeds into entries, categories, Craft Commerce products, and more. 293943.4k27](/packages/craftcms-feed-me)[maestroerror/laragent Power of AI Agents in your Laravel project 639142.5k](/packages/maestroerror-laragent)[verbb/formie The most user-friendly forms plugin for Craft. 100387.6k57](/packages/verbb-formie)[solspace/craft-freeform The most flexible and user-friendly form building plugin! 53675.5k15](/packages/solspace-craft-freeform)[verbb/navigation Create navigation menus for your site. 92698.4k18](/packages/verbb-navigation) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)