$ show weDevsOfficial/wedocs-plugin
weDocs is a WordPress plugin that adds comprehensive documentation and knowledge base management to any WordPress site. It registers a hierarchical 'docs' custom post type with a parent-section-article structure, allowing users to create, organize, and display documentation with modern editor blocks (search, grid, sidebar, table of contents, breadcrumbs, reading progress, etc.) and Elementor widgets. The plugin provides a full-featured React-based admin dashboard for managing docs, FAQs, and settings, including drag-and-drop reordering, inline editing, migration from BetterDocs, AI-powered content generation (via OpenAI, Anthropic, Google Gemini), and analytics (view counting, helpfulness votes). It follows a freemium model with pro features gated behind license checks and preview overlays. The codebase demonstrates strong engineering practices: extensive E2E tests with Playwright, modular PHP classes, reusable block controls and shared UI components, and efficient REST API endpoints with aggregate SQL queries. However, it has some code duplication (e.g., duplicate commonControls in two directories), reliance on experimental WordPress APIs, and large inline CSS/JS in PHP render outputs, which prevent it from being exceptional. Overall, it is a well-maintained, production-ready plugin with reusable patterns suitable for other WordPress block plugins.
The LLM identified 7 files worth highlighting for reuse:
Provides reusable JavaScript helpers for generating responsive CSS styles from block attributes (typography, spacing, border, shadow), as well as utility functions like debounce, classNames, and breakpoint detection. Designed to be extracted into any WordPress block plugin for consistent styling generation.
PHP counterpart to block-helpers.js, containing functions to build CSS declarations for typography, spacing, border, and shadow from block attribute values. Used by render.php files to output inline styles. Self-contained and easily reusable in other WordPress plugins needing server-side style generation.
A reusable confirmation dialog component built with @headlessui/react Dialog, published globally via window.wedocs for use by the Pro plugin. Demonstrates a clean pattern for modal confirmations with customizable title, message, and callback. Isolated and easily extractable.
A simple, accessible toggle switch component published globally for the Pro plugin. Uses @wordpress/components ToggleControl as base but wrapped for consistency and global sharing. Reusable pattern for any WordPress admin setting.
Implements the main REST API controller for weDocs, handling CRUD operations, admin tree listing with efficient descendant counts (aggregate SQL), AI content generation across multiple providers (OpenAI, Anthropic, Google), dynamic model listing via provider APIs, secure image upload for AI analysis, and helpfulness votes. The AI provider abstraction pattern (make_ai_api_call dispatching to provider-specific methods) and the descendant count SQL pattern are both reusable in other WordPress plugins.
Centrally manages AI service calls (OpenAI, Anthropic, Google) with a clean abstraction. Handles authentication, payload formatting, and response parsing. Commented-out error handling suggests it was designed for robustness. Could be extracted as a generic AI API client for WordPress projects.
Exports reusable React components (ColorSettingsPanel, SpacingPanel, BorderPanel, TypographyPanel) for Gutenberg block inspector controls. Each panel supports responsive modes (desktop, tablet, mobile) and consistent attribute handling. Demonstrates a well-organized pattern for building block settings UIs that can be reused across many blocks in any WordPress plugin.