Skip to content
Seeder is the easiest way to quickly create placeholder content while you're building out a website. Create your sections & fields and then let Seeder make entries for you.
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources
src Added support for Rias500/craft-position-fieldtype #9 Apr 22, 2019
tests Bootstrap file & initial field test Jun 1, 2018
.editorconfig.json Basic travis & editor config Jun 1, 2018
.gitignore
.travis.yml Basic travis & editor config Jun 1, 2018
CHANGELOG.md Added positionfield to readme Apr 22, 2019
LICENSE.md Plugin mvp Mar 23, 2018
README.md Added positionfield to readme Apr 22, 2019
codeception.yml Basic travis & editor config Jun 1, 2018
composer.json

README.md

Seeder plugin for Craft CMS 3.x

Seeder

Usage

Seeder allows you to quickly create dummy entries through the command line. And you can just as easily remove the dummy data when you're done building the site. With the plugin installed, running ./craft help seeder/generate will show you which commands are available

Since the plugin is only usefull during the development and not on a live site, charging money for it would be stupid (you could just free trial it every time). Instead you can download it for free and if you want to support future development, you can support it on beerpay.io. Thanks!

Beerpay

Installation

To install the plugin, follow these instructions.

  1. Open your terminal and go to your Craft project:

     cd /path/to/project
    
  2. Then tell Composer to load the plugin:

     composer require studioespresso/craft-seeder
    
  3. In the Control Panel, go to Settings → Plugins and click the “Install” button for "Seeder".

Entries (Section ID/handle, count)

Use the command below, followed by the --section option and the --number of entries you want to create (defaults to 20 if ommited). This command works with both section ID and handle.

./craft seeder/generate/entries --section=news --count=15

Categories (Category group ID/handle, count)

./craft seeder/generate/categories --group=labels --count=10

Users (Usergroup ID/handle, count)

./craft seeder/generate/users --group=editors --count=5

Clean up

Once you're done building out the site, the plugin gives you an easy way to remove the dummy data (entries, assets, categories and users). This can be done through the CP (click the Seeder section the sidebar) or through the command line with the following command:

./craft seeder/clean-up/all

Configuration options

eachMatrixBlock - Seed all blocktypes in a matrix field

For a matrix, the plugin will get a random set of block types within the minimum & maximum amounts of blocks the field allows.

With this setting set to true, we'll generate a each blocktype once in a random order. This is a good way to test pagebuilder/contentbuilder like fields

useLocalAssets - Use assets already in your site to seed asset fields

'useLocalAssets' => [
    'volumeId' => 1,
    'path' => 'test/'
]

Add the array above to config/seeder.php to seed using assets from volume 1 and folder test/.

Troubleshooting

The most common problem with the plugins is getting the following error:

Unknown command: seeder/generate/entries

If you have the plugin installed in the CP and are seeing this message, craft can not connect to your database through the command line. Your site probably works correctly but CLI commands won't.

If you're running MAMP/XAMP, you should use 127.0.0.1 as hostname instead of localhost.

Roadmap

Core elements

  • Entries
  • Categories
  • Users
  • Entry fields
  • User fields
  • Category fields
  • Asset fields

Core fields

  • Title
  • Plain text
  • Email
  • Url
  • Color
  • Date
  • Entries
  • Categories
  • Dropdown
  • Checkboxes
  • Radio buttons
  • Multi select
  • Assets
  • Matrix
  • Lightswitch
  • Table
  • Tags
  • Users

Plugin elements

  • Commerce products & variants

Plugin fields

You can’t perform that action at this time.