Description
Nirdeshio is a product documentation and knowledge base plugin built for WordPress. It helps software companies, plugin/theme developers, SaaS founders, WooCommerce sellers, and agencies publish beautiful, fast-loading documentation without slowing down their sites.
Why Nirdeshio?
Most documentation plugins load heavy JavaScript, conflict with popular themes, or require dozens of settings before your first article appears. Nirdeshio is different:
- 5-minute setup — A built-in wizard creates your first documentation portal and publishes it before your coffee gets cold.
- Zero theme conflict — Every frontend element is scoped under
.itsdz-docs, so Nirdeshio never leaks styles into your theme. - Ultra-light frontend — Less than 30 KB of JavaScript (gzipped). The search modal loads on-demand only when the user opens it.
- No jQuery — Built with modern Vanilla TypeScript and React for the admin.
- Performance-first — Views are buffered and written to the database in batches every 5 minutes, not on every page load.
Free Features
- Documentation projects (knowledge bases) — no cap, create as many as you need
- Unlimited sections (3 levels deep), unlimited articles
- Sections manager — a dedicated screen to create, rename, re-nest, icon, and delete sections without touching individual articles
- Drag-and-drop article ordering
- Gutenberg block editor support + shortcodes
- Instant full-text search (MySQL FULLTEXT — no
LIKE %keyword%) - Auto-generated table of contents, breadcrumbs, Previous / Next navigation
- Related articles
- Light / dark mode (respects system preference, user-toggleable)
- Print-friendly layout
- Mobile slide-out navigation
- « Was this helpful? » feedback system
- Reading time estimate, author byline, and last-updated date
- Content freshness tracking — log a review date per article and spot stale docs at a glance
- WordPress dashboard widget — see draft, stale, and unsectioned article counts without leaving your Dashboard
- Basic view counter (buffered, performance-safe)
- Two layout modes: canvas (full-page, no theme header/footer) and theme (integrates with your active theme)
- Three template styles: Clean, Modern, Compact
- Custom brand color per knowledge base
- Project logo and landing intro — upload a logo and write a custom intro line for each knowledge base’s homepage
- Custom navigation styles — choose Accordion, Rail, or Tree for how the sidebar organizes sections and articles
- Header links — add up to 4 custom links (e.g. « Contact support », « Changelog ») to the documentation header
- Custom CSS per project — fine-tune the look of a specific knowledge base without a child theme
- Import / export (JSON)
- Markdown import — drop in a
.mdfile and it lands as a draft article, ready to review and publish - One-click sample content — publishes a complete demo knowledge base so you can see the result before writing anything, and removes it just as easily
- Glossary — define your product’s terminology once; the first mention of each term in an article is highlighted with a tooltip definition, and the full list can be embedded anywhere
- Translation-ready, RTL support
- SEO plugin compatible (Yoast SEO, Rank Math, AIOSEO)
AI-Ready Documentation
Assistants like ChatGPT, Claude and Perplexity increasingly read documentation on behalf of your users. Nirdeshio makes that work properly instead of leaving them to guess from rendered HTML.
/llms.txt— an automatically generated, always up-to-date map of your documentation following the llmstxt.org convention. One line per article with a short summary, grouped by project./llms-full.txt— the same index plus the complete plain-text body of every article, for assistants that can ingest the whole corpus.- Copy as Markdown — a button on every article that copies clean Markdown to the clipboard, ready to paste into an AI chat, an issue, or a pull request.
Only published articles in published projects are ever included. Both routes are cached and can be switched off with a single filter:
add_filter( 'itsdz_llms_txt_enabled', '__return_false' );
Gutenberg Blocks
- Nirdeshio Search — Embed a search box anywhere on your site. Submits to your KB page and auto-opens the search modal with the entered query pre-filled.
- Nirdeshio Article List — Display a linked list of articles from any KB. Ideal for sidebars, landing pages, or related-content widgets.
- Nirdeshio Popular Articles — Rank articles by view count or publish date. Great for « Top questions » sections on a support landing page.
- Nirdeshio FAQ — Build a collapsible question-and-answer list. Automatically outputs FAQPage structured data so your questions can appear directly in search results.
- Nirdeshio Glossary — Display every defined term with its definition, sorted alphabetically.
- Nirdeshio Callout — A coloured note, tip, warning, or danger box inside an article. Insert it from the block inserter while writing.
Shortcodes
[nirdeshio_search kb_id="123"]— search form for a specific KB[nirdeshio_docs_list kb_id="123" limit="5" show_section="true"]— article list[nirdeshio_popular_docs kb_id="123" limit="5" order="popular"]— most viewed (ororder="recent") articles[nirdeshio_faq heading="Billing"]— FAQ list; write oneQuestion | Answerpair per line between the opening and closing tags[nirdeshio_glossary heading="Glossary" show_aliases="true"]— alphabetical list of every glossary term
Glossary auto-highlighting never touches links, headings or code samples, and can be switched off entirely:
add_filter( 'itsdz_glossary_autolink', '__return_false' );
Nirdeshio Pro
Available now, as a separate add-on plugin (requires this free plugin to be active):
- WooCommerce integration — link articles to products; linked products automatically get a « Documentation » tab listing them
Coming soon to Nirdeshio Pro:
- Knowledge base switcher UI for managing many projects at once
- Product versioning (v1.x / v2.x switcher with version-specific URLs)
- Advanced analytics dashboard (health score, no-result searches, exit rate)
- Access control (role-based, password-protected, buyer-gated docs)
- Additional templates + visual customizer
- Contributor workflow (review, approval, scheduled publishing)
- Importers for BetterDocs, EazyDocs, weDocs, Echo Knowledge Base, Markdown, CSV
- AI assistant (outline generator, draft from existing content, FAQ generator)
Privacy
Nirdeshio does not send any data to external servers. The « Was this helpful? » feedback and view counts are stored locally in your WordPress database. IP addresses are stored as irreversible hashes (SHA-256) for rate-limiting purposes only.
When uninstalling, data is deleted only if you opt in to data removal in the plugin settings. By default, your content and settings are preserved.
Source Code
Source code and build instructions: https://github.com/itsmanzur/itsmanzur-docs/
Blocs
Cette extension fournit 6 blocs.
- Nirdeshio Glossary Display every glossary term with its definition, sorted alphabetically.
- Nirdeshio Article List Display a list of documentation articles from a knowledge base — useful for sidebars, landing pages, and related-content sections.
- Nirdeshio FAQ Add a list of frequently asked questions with collapsible answers. Outputs FAQPage structured data so the questions can appear in search results.
- Nirdeshio Search Embed a documentation search box anywhere on your site. Submits to the chosen knowledge base and auto-opens the search modal with the entered query.
- Nirdeshio Popular Articles Show the most viewed or most recently published articles from a knowledge base.
- Nirdeshio Callout A coloured note, tip, warning or caution box for calling out important information inside an article.
Installation
Automatic installation (recommended)
- Log in to your WordPress admin panel and go to Plugins Add New.
- Search for Nirdeshio.
- Click Install Now, then Activate.
Manual installation
- Download the plugin ZIP from the WordPress.org plugin directory.
- Go to Plugins Add New Upload Plugin.
- Choose the ZIP file and click Install Now, then Activate.
After activation
- Go to Nirdeshio in your admin sidebar.
- The Setup Wizard launches automatically — follow the 5 steps to publish your first documentation portal.
FAQ
-
Will Nirdeshio conflict with my theme?
-
No. Nirdeshio uses two layout modes. In canvas mode (the default), it renders a fully independent page that bypasses your theme entirely. In theme mode, it integrates with your theme’s header and footer, and all CSS is scoped under
.itsdz-docsso it cannot affect other parts of your site. -
Does Nirdeshio slow down my site?
-
No — in fact, we designed Nirdeshio specifically to avoid the performance problems common in other documentation plugins:
- Assets load only on documentation pages (conditional enqueue).
- The search modal JavaScript is loaded on-demand, only when the user opens the search.
- Page views are written to the database in 5-minute batches, never on every request.
- The frontend bundle is under 30 KB gzipped.
-
How is Nirdeshio search different from the built-in WordPress search?
-
Nirdeshio uses a dedicated search index table with MySQL FULLTEXT indexing. It never runs
LIKE %keyword%queries againstwp_posts, which are slow and load your entire database. Searches are also cached in the object cache (Redis / Memcached if available, transients otherwise). -
Can I use Nirdeshio with the Classic Editor?
-
Yes. Both
[nirdeshio_search]and[nirdeshio_docs_list]shortcodes work in any editor, widget, or page builder that supports shortcodes. -
Is Nirdeshio compatible with page caching plugins?
-
Yes. The feedback (« Was this helpful? ») system uses JavaScript + REST API instead of PHP sessions, so it works correctly behind WP Rocket, LiteSpeed Cache, W3 Total Cache, and similar caching plugins.
-
Can I translate Nirdeshio?
-
Yes. Nirdeshio is fully internationalized (i18n). All strings use the
itsmanzur-docstext domain. Translations can be contributed on translate.wordpress.org. -
Does Nirdeshio work with RTL languages?
-
Yes. The compiled CSS includes an automatically generated RTL stylesheet (
style-frontend-rtl.css) loaded by WordPress when an RTL language is active. -
How many knowledge bases can I have in the free version?
-
As many as you like — there is no limit in the free version.
-
Where is my data stored?
-
All data is stored in your WordPress database. Nirdeshio creates four custom tables:
{prefix}itsdz_search_index,{prefix}itsdz_search_log,{prefix}itsdz_feedback, and{prefix}itsdz_views. Articles and knowledge bases are stored as standard WordPress custom post types and can be exported like any other post type.
Avis
Il n’y a aucun avis pour cette extension.
Contributeurs/contributrices & développeurs/développeuses
« Nirdeshio – Documentation, Knowledge Base & Help Center for WordPress » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
ContributeursLe développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal des modifications
1.1.0
New: Sections manager
- Added a dedicated Sections screen — create, rename, re-nest, set a Dashicon, and delete sections without opening an article.
New: Markdown import
- Import a
.mdfile directly as a draft article from the Import / Export screen.
New: Project appearance & navigation
- Added Accordion, Rail, and Tree navigation styles — pick how the sidebar organizes sections and articles per project.
- Added per-project logo upload and a customizable landing-page intro line.
- Added optional header links (up to 4) for linking out to support, changelog, or any custom page.
- Added per-project custom CSS.
- Table of contents, feedback, related articles, and print button can each now be toggled on or off per project.
New: WordPress dashboard widget
- Added a dashboard widget showing draft, stale (90+ days unreviewed), and unsectioned article counts.
Shortcode names changed (breaking)
- All shortcodes were renamed to match the plugin’s public name:
[doczur_search][nirdeshio_search], and similarly fordoczur_docs_list,doczur_popular_docs,doczur_faq, anddoczur_glossary. There is no backward-compatible alias — if you used the old shortcode names anywhere, update them after upgrading.
Fixes
- The article list REST endpoint now paginates correctly instead of silently truncating at 100 articles.
- Saving a custom URL slug base now reliably flushes rewrite rules so the new slug takes effect immediately.
1.0.0
Editor
- Article editing now happens entirely in the native WordPress block editor (Gutenberg) — no HTML tags are ever shown, and every core block (images, tables, lists) is available.
- Added a « Nirdeshio » panel to the block editor’s sidebar for section, version, tags and the « Mark reviewed today » control — no separate metadata form.
- Added a « Nirdeshio Callout » block (Info / Tip / Warning / Danger) for coloured notes inside an article, insertable from the regular block inserter.
- The Documentation screen is now a lightweight tree: search, drag-and-drop ordering, bulk actions, and a « + New » button that opens straight into the editor.
AI-ready documentation
- Added
/llms.txt, an automatically generated map of your documentation following the llmstxt.org convention. - Added
/llms-full.txt, which also includes the full text of every published article. - Added a « Copy as Markdown » button to every article.
- Both routes are cached, exclude unpublished content, and can be disabled with the
itsdz_llms_txt_enabledfilter.
Glossary
- Added a glossary: define a term once and the first mention in each article gains a tooltip definition.
- Alternative spellings are supported, so plurals and abbreviations match too.
- Auto-highlighting never alters links, headings, code samples or HTML attributes, and can be disabled with the
itsdz_glossary_autolinkfilter. - Added the
itsdz/glossaryblock and[nirdeshio_glossary]shortcode.
New blocks and shortcodes
itsdz/faqand[nirdeshio_faq]— collapsible question lists that also emit FAQPage structured data.itsdz/popular-docsand[nirdeshio_popular_docs]— rank articles by views or publish date.- All blocks now ship an editor interface, so their settings can be configured from the block sidebar.
Content maintenance
- Articles can record a review date; anything unreviewed for 90 days is flagged in the article list.
- Added one-click sample content that publishes a complete demo knowledge base and removes it just as cleanly.
- Articles now display their author and, when set, the date they were last reviewed.
UI polish
- The KB landing page no longer shows a duplicate search box — the top navigation search is now hidden on the landing page in favour of the hero search, and stays visible on article pages.
- Section cards without a custom icon now show a monogram of the section name instead of a generic « § » placeholder.
- Improved field spacing and button contrast on the Glossary admin screen.
Under the hood
- Added a WordPress integration test suite alongside the existing unit tests.
- Added a small extension architecture: the
itsdz_servicesfilter lets an add-on register its own backend services,itsdz_kb_overview_extralets one add data to the Documentation screen’s overview panel, anditsdz_is_pro_active()is a simple informational check for « is an add-on active » — none of it is used by anything in this free plugin itself.
0.1.0
- Initial public release.
- Knowledge base and article custom post types with section, tag, and version taxonomies.
- Setup Wizard (5 steps), Documentation Tree Builder, Settings screen, Import/Export UI.
- Gutenberg block editor admin interface (React + TypeScript).
- Instant full-text search with MySQL FULLTEXT index.
- Auto table of contents, breadcrumbs, Previous/Next navigation, related articles.
- « Was this helpful? » feedback system.
- Buffered view counter (5-minute WP-Cron flush, Action Scheduler compatible).
- Dark mode, print layout, mobile slide-out navigation.
itsdz/searchanditsdz/docs-listGutenberg blocks.[nirdeshio_search]and[nirdeshio_docs_list]shortcodes.- Canvas and theme layout modes.
- Clean, Modern, and Compact template styles.
- Translation-ready with RTL support.
- REST API (
itsdz/v1) for admin and public endpoints.
