PHPackages kalprajsolutions/laravel-wordpress-cda - 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. [Caching](/categories/caching) 4. / 5. kalprajsolutions/laravel-wordpress-cda ActiveLibrary[Caching](/categories/caching) kalprajsolutions/laravel-wordpress-cda ====================================== WordPress blog caching functionality for Laravel applications v1.3(3mo ago)123MITPHPPHP ^8.1 Since Mar 8Pushed 3mo agoCompare [ Source](https://github.com/kalprajsolutions/laravel-wordpress-cda)[ Packagist](https://packagist.org/packages/kalprajsolutions/laravel-wordpress-cda)[ Docs](https://github.com/kalprajsolutions/wordpress-blog-system)[ RSS](/packages/kalprajsolutions-laravel-wordpress-cda/feed)WikiDiscussions main Synced 3w ago READMEChangelog (3)Dependencies (4)Versions (4)Used By (0) [ ![Logo for Laravel Wordpress CDA](https://github.com/Pushkraj19/Pushkraj19/raw/d72ff5e2eb7299546cd8348c25fd835a39becce0/laravel-wordpress-cda.png) ](https://kalprajsolutions.com/?utm_source=github&utm_medium=banner&utm_campaign=laravel-wordpress-cda) Laravel WordPress CDA (Content Delivery Adapter) ================================================ [](#laravel-wordpress-cda-content-delivery-adapter) A Laravel package that integrates WordPress as a headless CMS, fetching blog posts via the WordPress REST API and serving them locally with Laravel Eloquent-like model types. Perfect for maintaining a WordPress blog backend while serving content through your Laravel application. Features -------- [](#features) - **WordPress API Integration**: Fetch posts, categories, tags, and authors from any WordPress REST API - **Author-Specific Content**: Filter posts by a specific WordPress author - **Laravel-Eloquent-Like Models**: Wrapper models (`WordPressPost`, `WordPressCategory`, `WordPressTag`, `WordPressUser`) that mimic Laravel Eloquent for seamless integration - **Local Image Caching**: Automatically download and cache WordPress images locally with SEO-friendly paths - **Content Image Processing**: Replace WordPress image URLs in post content with local cached versions - **Parallel Image Downloads**: Batch download multiple images concurrently for faster caching - **Built-in Caching**: Comprehensive caching for API responses and processed content - **Yoast SEO Support**: Extracts and provides Yoast SEO meta data (title, description, Open Graph, Twitter Cards) - **Pagination Support**: Full pagination support for post listings - **Featured Posts**: Support for WordPress sticky/pinned posts - **Author Categories & Tags**: Get categories and tags specific to the configured author - **Console Commands**: Artisan commands to cache content and images - **Authentication Support**: WordPress Application Password authentication for private content - **View Compatibility**: Compatible with Canvas and other popular blog themes Installation ------------ [](#installation) ``` composer require kalprajsolutions/laravel-wordpress-cda ``` Configuration ------------- [](#configuration) Publish the configuration file: ``` php artisan vendor:publish --provider="KalprajSolutions\LaravelWordpressCda\WordPressCdaServiceProvider" --tag="wordpress-blog-config" ``` Configure your `.env` file: ``` # WordPress REST API Base URL WP_API_BASE_URL=https://your-wordpress-site.com/wp-json/wp/v2 # Author ID to filter posts (get this from WordPress Admin > Users) WP_API_AUTHOR_ID=1 # Posts per page for API requests (max 100) WP_API_PER_PAGE=100 # Cache duration in minutes WP_API_CACHE_DURATION=60 # Cache prefix for this package (default: wp_cda_) WP_API_CACHE_PREFIX=wp_cda_ # Custom User-Agent string for API requests WP_API_USER_AGENT=Laravel-WordPress-CDA/1.0 # Route name for blog post view (used for URL generation) WP_API_BLOG_VIEW_ROUTE=blog.view # Storage disk for cached images (configure in filesystems.php) WP_API_FILESYSTEM_DISK=public # Preserve WordPress year/month folder structure for images (true/false) WP_API_PRESERVE_STRUCTURE=true # Authentication (optional - for private WordPress content) WP_API_AUTH_ENABLED=false WP_API_USERNAME=your_username WP_API_APP_PASSWORD=xxxx xxxx xxxx xxxx ``` Caching ------- [](#caching) This package uses Laravel's cache system with tags to provide isolated cache management. All cached data is tagged with `wordpress_cda`, allowing you to flush only the WordPress CDA package cache without affecting other cached data in your application. ### Cache Configuration [](#cache-configuration) SettingDefaultDescription**Cache Prefix**`wp_cda_`Prepended to all cache keys**Cache Tags**`['wordpress_cda']`Tag-based cache grouping**Cache Duration**`60` minutesHow long data is cached### Customizing Cache Prefix and Tags [](#customizing-cache-prefix-and-tags) You can customize the cache prefix via the environment variable: ``` WP_API_CACHE_PREFIX=my_custom_prefix_ ``` To customize cache tags, publish the config file and modify the `cache_tags` array directly in `config/wordpress.php`: ``` // config/wordpress.php 'cache_tags' => ['wordpress_cda', 'my_custom_tag'], ``` ### Cache Driver Requirements [](#cache-driver-requirements) > **Important:** Cache tags require a cache driver that supports tagging. Supported drivers include: - **Redis** (recommended) - **Memcached** Using drivers that don't support tags (like `file`, `database`, or `array`) will result in errors when using this package. ### Flushing the Cache [](#flushing-the-cache) There are two ways to clear the WordPress CDA package cache: #### Using Cache Tags [](#using-cache-tags) ``` use Illuminate\Support\Facades\Cache; // Flush all WordPress CDA cache Cache::tags(['wordpress_cda'])->flush(); ``` #### Using the Service Method [](#using-the-service-method) ``` use KalprajSolutions\LaravelWordpressCda\Services\WordPressApiService; // Clear all cached posts app(WordPressApiService::class)->clearPostsCache(); // Clear cache for a specific post app(WordPressApiService::class)->clearPostCache($postId); ``` #### Using the Repository [](#using-the-repository) ``` use KalprajSolutions\LaravelWordpressCda\Repositories\WordPressPostRepository; $repository = app(WordPressPostRepository::class); // Clear all cache $repository->clearCache(); // Clear cache for a specific post $repository->clearPostCache($postId); ``` Usage ----- [](#usage) ### Using the Repository [](#using-the-repository-1) ``` use KalprajSolutions\LaravelWordpressCda\Repositories\WordPressPostRepository; $repository = app(WordPressPostRepository::class); // Get all posts with pagination $posts = $repository->getAllPosts(10, 1); // Get a single post by slug $post = $repository->getPostBySlug('my-blog-post'); // Get a single post with immediate image caching $post = $repository->getPostBySlug('my-blog-post', true); // Get posts by category $posts = $repository->getPostsByCategory('technology'); // Get posts by tag $posts = $repository->getPostsByTag('laravel'); // Get recent posts $recentPosts = $repository->getRecentPosts(5); // Get featured/sticky posts $featuredPosts = $repository->getFeaturedPosts(3); // Get posts by specific author $authorPosts = $repository->getPostsByAuthor($authorId, 10); // Search posts $results = $repository->searchPosts('search term'); // Get related posts $related = $repository->getRelatedPosts($post, 4); // Get author's categories with post counts $categories = $repository->getAuthorCategories(); // Get author's tags $tags = $repository->getAuthorTags(); // Clear cache $repository->clearCache(); $repository->clearPostCache($postId); ``` ### Using the Model [](#using-the-model) ``` use KalprajSolutions\LaravelWordpressCda\Models\WordPressPost; // Access post properties $post->id; $post->title; $post->slug; $post->summary; $post->body; // Processed content with local images $post->rawBody; // Raw content without processing $post->getRawBody(); // Also available as method $post->featured_image; // Auto-cached featured image $post->published_at; // Carbon instance $post->status; $post->format; // Relationships (return collections) $post->categories(); // WordPressCategory collection $post->tags(); // WordPressTag collection $post->user(); // WordPressUser instance $post->topic(); // Primary category (alias) $post->comments(); // Comments collection // SEO Meta (Yoast) $post->meta['title']; $post->meta['description']; $post->meta['canonical_link']; $post->meta['og_title']; $post->meta['og_description']; $post->meta['og_image']; $post->meta['twitter_title']; $post->meta['twitter_description']; $post->meta['twitter_image']; // Helper methods $post->getUrl(); $post->getPublishedDate(); // "March 8, 2026" $post->getPublishedDateDiff(); // "2 days ago" $post->getReadingTime(); // 5 (minutes) $post->getReadingTime(250); // Custom words per minute $post->hasComments(); $post->commentCount(); $post->getFormattedImage('full'); // Resize and cache featured image // Image processing control $post->setProcessContentImages(false); // Disable automatic image processing $post->clearProcessedBodyCache(); // Clear cached processed content // Access original API data $post->getOriginalData(); // Array/JSON serialization $post->toArray(); $post->toJson(); json_encode($post); // Uses JsonSerializable ``` ### Using Category, Tag, and User Models [](#using-category-tag-and-user-models) ``` use KalprajSolutions\LaravelWordpressCda\Models\WordPressCategory; use KalprajSolutions\LaravelWordpressCda\Models\WordPressTag; use KalprajSolutions\LaravelWordpressCda\Models\WordPressUser; // WordPressCategory $category->id; $category->name; $category->slug; $category->description; $category->count; // Number of posts in this category $category->parent; // Parent category ID (0 for top-level) $category->isTopLevel(); // Check if it's a top-level category $category->getUrl(); // Category URL // WordPressTag $tag->id; $tag->name; $tag->slug; $tag->description; $tag->count; // Number of posts with this tag $tag->getUrl(); // Tag URL // WordPressUser (Author) $user->id; $user->name; $user->slug; $user->url; // Author's website URL $user->description; // Author bio $user->avatarUrls; // Array of avatar URLs by size $user->getAvatarUrl(); // Get avatar URL (24, 48, or 96) ``` ### Using the Console Command [](#using-the-console-command) Cache all blog content: ``` # Cache all posts, categories, and tags php artisan wp:cache # Cache only first 5 pages php artisan wp:cache --pages=5 # Cache posts AND images php artisan wp:cache --images # Clean cache before caching php artisan wp:cache --clean --images ``` View Compatibility ------------------ [](#view-compatibility) The `WordPressPost` model is designed to be compatible with Canvas (or similar) blog models. It implements: - `ArrayAccess` for meta data access (`$post['title']`) - `Arrayable` for `toArray()` method - `Jsonable` for `toJson()` method - `JsonSerializable` for `json_encode()` support Access content in Blade templates: ``` @foreach($posts as $post) {{ $post->title }} {{ $post->summary }} {!! $post->body !!} {{ $post->getPublishedDate() }} {{ $post->getReadingTime() }} min read @endforeach ``` Storage Setup ------------- [](#storage-setup) ### Image Cache Disk [](#image-cache-disk) Configure the disk for cached images in `config/filesystems.php`: ``` 'disks' => [ // ... 'wordpress' => [ 'driver' => 'local', 'root' => public_path('content'), 'url' => env('APP_URL') . '/content', 'visibility' => 'public', 'throw' => false, ], ], ``` The default disk is `public`. You can also use `local`, `s3`, or any other configured disk. ### Image Path Structure [](#image-path-structure) By default, images preserve WordPress's year/month structure: - `2026/03/image.jpg` Set `WP_API_PRESERVE_STRUCTURE=false` to use hashed filenames: - `images/a1b2c3d4..._20260310_123456_abc123def.jpg` Architecture ------------ [](#architecture) ``` graph TB A[Laravel Application] --> B[WordPressPostRepository] B --> D[WordPressApiService] B --> E[WordPressImageService] D --> F[WordPress REST API] E --> G[Local Storage] E --> F B --> H[ContentImageProcessor] H --> E I[Console Command] --> B I --> E I --> H ``` Loading ``` graph TB J[Models] --> K[WordPressPost] J --> L[WordPressCategory] J --> M[WordPressTag] J --> N[WordPressUser] ``` Loading Requirements ------------ [](#requirements) - PHP 8.1+ - Laravel 10.0+ or 11.0 - intervention/image ^3.0 License ------- [](#license) MIT License - see [LICENSE](LICENSE) file for details. Author ------ [](#author) Kalpraj Solutions - kalprajsolutions.com ### Health Score 37 — LowBetter than 81% of packages Maintenance80 Actively maintained with recent releases Popularity8 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 ~1 days Total 3 Last Release 109d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b0ae2d708bbc168482ce80b191cdd557ad7ccff3146020b07feabe1a96346229?d=identicon)[kalprajsolutions](/maintainers/kalprajsolutions) --- Top Contributors [![Pushkraj19](https://avatars.githubusercontent.com/u/29335514?v=4)](https://github.com/Pushkraj19 "Pushkraj19 (10 commits)") --- Tags bloggingcmslaravelphpwordpressapilaravelwordpresscachingblog ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/kalprajsolutions-laravel-wordpress-cda/health.svg) ``` [![Health](https://phpackages.com/badges/kalprajsolutions-laravel-wordpress-cda/health.svg)](https://phpackages.com/packages/kalprajsolutions-laravel-wordpress-cda) ``` ### Alternatives [unopim/unopim UnoPim Laravel PIM 10.3k2.2k](/packages/unopim-unopim)[api-platform/laravel API Platform support for Laravel 59156.3k11](/packages/api-platform-laravel)[kompo/kompo Laravel & Vue.js FullStack Components for Rapid Application Development 11914.4k42](/packages/kompo-kompo) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)