Skip to content
This repository has been archived by the owner on Nov 23, 2024. It is now read-only.
/ kirby3-random Public archive

Kirby Tag and Page Method to generate various random values

License

Notifications You must be signed in to change notification settings

bnomei/kirby3-random

Repository files navigation

Kirby Random

Release Downloads Build Status Coverage Status Maintainability Twitter

Kirby Tag and Page Method to generate various random values.

Installation

  • unzip master.zip as folder site/plugins/kirby3-random or
  • git submodule add https://github.com/bnomei/kirby3-random.git site/plugins/kirby3-random or
  • composer require bnomei/kirby3-random

Usage

Regex/Info Kirbytag Page-Method Static
[0-9]{1,3} (random: 999 generator: number) $page->random(999) Random::number(0, 999)
[0-9]{1} (random: 0, 9 generator: between) $page->random([0, 9], 'between') Random::between([0, 9])
(\d\w){5,10} (random:) $page->random() Random::string()
\d{5} (random: 5 generator: num) $page->random(5, 'num') Random::string(5, 'num')
(apple OR banana OR coconut) (random: apple, banana, coconut generator: pick) $page->random('apple, banana, coconut', 'pick') Random::pick(['apple', 'banana', 'coconut'])
5 chars (random: chars generator: lorem length: 5) $page->random('chars', 'lorem', 5) Random::lorem(5, 'chars')
5 words (random: words generator: lorem length: 5) $page->random('words', 'lorem', 5) Random::lorem(5, 'words')
5 sentences (random: sentences generator: lorem length: 5) $page->random('sentences', 'lorem', 5) Random::lorem(5, 'sentences')
5 [paragaph PHP_EOL PHP_EOL] (random: paragraphs generator: lorem length: 5) $page->random('paragraphs', 'lorem', 5) Random::lorem(5, 'paragraphs')
[a-zA-Z0-9]{40} (random: generator: token) $page->random(null, 'token') Random::token()
[A-Z0-9]{12} (random: alphaupper, num generator: token length: 12) $page->random('alphaupper, num', 'token', 12) Random::token(12, 'alphaupper, num')

Markdown tables do not allow | in regex so i wrote OR instead. For all random numbers the cryptographically safe PHP 7 function rand_int is used. Bnomei\Random can be used as Random if use Bnomei\Random; is included at the head of the PHP script.

Dependencies

Disclaimer

This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.

License

MIT

It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.