# Test Content Generator

Plugin Name:       Test Content Generator  
Plugin URI:        https://codeberg.org/kifd-WordPress/TestContentGenerator  
Contributors:      keith_wp  
Author Link:       https://drakard.com/  
Requires at least: 4.0 or higher  
Tested up to:      6.7.2  
Requires PHP:      8.3  
Stable tag:        0.4.4  
License:           BSD-3-Clause  
License URI:       https://directory.fsf.org/wiki/License:BSD-3-Clause  
Tags:              test content, lorem ipsum, test posts, lipsum, wp cli  


Quickly generate a test site full of random users, posts, comments, tags and images.


## Description

Developing any WP plugin or theme often means needing to test it against as much of a "real site" as your development environment will allow, and if you're adding that test data by hand, it gets pretty tedious pretty quickly.

This plugin will let you use either [WP-CLI](https://wp-cli.org/) commands, or the admin page in Tools->**Content Generator** to add test users, populate the Media Library with example images, an additional test custom post type and custom taxonomies, generate as many test "_Lorem Ipsum_" posts as you want, and then add comments to those posts.

Each of those "_Lorem Ipsum_" posts will be randomly tagged and categorised, and can also be assigned one of the test images as its Featured Image, as well as a variety of HTML content in addition to the usual paragraphs.

This plugin is primarily for people who need to test plugins and themes on a regular basis, but it would let anyone get a feel of how their site will look when it's full of real content.


### Workflow

All the parts of this plugin are optional, and each can be repeated as much as you want, depending on which parts of your site you want to test.

However, no individual step will "backfill" preceeding ones automatically, so if you have an empty site and you want (eg.) your test _Posts_ to appear to have been written by different people, then you need to add the test _Users_ first.

ie.

* Enable **Custom** (Post Types & Categories & Tags) before adding terms from your **Taxonomies**,
* Add **Users** before downloading **Images** before generating **Posts** before adding **Comments**.


### WP CLI Integration

Using the plugin defaults, you can populate a test site with just the following commands:

1. `wp plugin install test-content-generator --activate`
    Download and activate the plugin.
2. `wp test users --amount=20`
    Add 20 random Editor/Author/Contributor/Subscribers users who have registered within the last 60 days.
3. `wp test taxonomies --amount=50`
    Add 50 taxonomy terms split between Categories and Post Tags.
4. `wp test images --amount=10`
    Add 10 images of size 800x400 uploaded by any Editor/Author.
5. `wp test posts --amount=40`
    Add 40 Posts written within the last 60 days by any Editor/Author/Contributor, with a Featured Image and both categorised and tagged.
6. `wp test comments --amount=100`
    Add 100 comments to your Posts written within the last 60 days by any of the registered users.


See `wp help test` for more details.


## Screenshots

1. Generating new test _Posts_.
2. An example of the output using the *Polite* theme.
3. Create any role of user in the _Users_ screen.
4. Adding _Images_ to your Media Library.
5. The _Custom Post Type_ and _Custom Taxonomies_ can be enabled separately.
6. Add test terms to all of your _Taxonomies_.
7. Fill out your frontend by adding _Comments_ to your content. 



## Changelog

### 0.4.4
* Fix: Stopped creating deprecated dynamic properties for PHP 8.3

### 0.4.3
* Tested against 6.7.2
* Fix: Moved the translation text domain loading to later in the init

### 0.4.2
* Tested against 6.4.3, 6.5 and 6.6.1
* Fix: Moved the run() callback of register_setting() into the abstract class (DRY)
* Fix: Switched use of rand() to wp_rand() to stop the plugin check whining
* Fix: Added translator notes for the various placeholders

### 0.4.1
* Fix: Changed how some string arrays are passed via CLI to be consistent
* Fix: Uses gmdate/wp_json_encode instead of date/json_encode

### 0.4
* Feature: Added WP-CLI integration

### 0.3
* Tested against 6.4 and 6.3.2
* Feature: Added ability to fill media library from https://picsum.photos/
* Feature: Added featured images, user creation, comment creation
* Feature: Added a better settings page
* Initial public release

### 0.2
* Feature: Added the lipsum routines to generate posts and terms

### 0.1
* Original plugin - add some test posts