Random pictures in media library

About

This repository contains a plugin for WordPress that allows you to store any number of random images in the media library.

These are obtained from various external sources from which you can choose.

Optionally, it is also possible to store the random images in a directory on the hosting server.

Hint

The plugin can actually only be used via WP CLI.

Usage

1. Install and activate a release of this plugin.
2. Run this command on your console and check its options: wp rpml import

Usage for developer

After checkout go through the following steps:

1. Run composer update

Release

from local environment with Taskfile

1. execute the following command in main directory: task release -- 1.0.0 - adjust the version number.
2. after that you will find a zip file in the release directory which could be used in WordPress to install it.

on GitHub

1. Create a new tag with the new version number.
2. The release zip will be created by GitHub action.

Translations

I recommend to use PoEdit to translate texts for this plugin.

generate pot-file

Run in main directory:

wp i18n make-pot . languages/random-pictures-in-media-library --exclude=svn/

update translation-file

1. Open .po-file of the language in PoEdit.
2. Go to "Translate" > "Update from POT-file".
3. After this the new entries are added to the language-file.

export translation-file

1. Open .po-file of the language in PoEdit.
2. Go to File > Save.
3. Upload the generated .mo-file and the .po-file to the plugin-folder languages/

Check for WordPress Coding Standards

Initialize

composer install

Run

vendor/bin/phpcs --standard=ruleset.xml .

Repair

vendor/bin/phpcbf --standard=ruleset.xml .

Generate documentation

vendor/bin/wp-documentor parse app --format=markdown --output=docs/hooks.md --prefix=rpml_

Check for WordPress VIP Coding Standards

Hint: this check runs against the VIP-GO-platform which is not our target for this plugin. Many warnings can be ignored.

Run

vendor/bin/phpcs --extensions=php --ignore=*/attributes/*,*/blocks/*,*/example/*,*/css/*,*/vendor/*,*/node_modules/*,*/svn/* --standard=WordPress-VIP-Go .

Analyse with PHPStan

vendor/bin/phpstan analyse