Console

Tiki Console is to administer your Tiki instance via the command line. It is based on Symfony's Console Component.

You can also use via instance:console in Tiki Manager

Please note that the following information is given for Tiki LTS versions, more commands exists and this list will be updated as the next LTS is released. Source code for next version of Tiki is here: https://gitlab.com/tikiwiki/tiki/-/tree/master/lib/core/Tiki/Command

Type this command in the base directory of your Tiki instance to discover all the commands for your version.
Copy to clipboard
php console.php


If you want to learn the inner workings, source code is here: https://gitlab.com/tikiwiki/tiki/-/tree/24.x/lib/core/Tiki/Command

Copy to clipboard
user@server:/www/tiki$ php console.php Tiki Console Tool Usage: command [options] [arguments] Options: -h, --help Display this help message -q, --quiet Do not output any message -V, --version Display this application version --ansi Force ANSI output --no-ansi Disable ANSI output -n, --no-interaction Do not ask any interactive question --site=SITE Multi-Tiki instance --as-user=AS-USER Run the command as a different Tiki user -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug Available commands: help Displays help for a command list Lists commands backup backup:files Create a backup of Tiki instance files cache cache:clear Clear Tiki caches cache:generate Generate Tiki caches daily-report daily-report:send Send daily user reports database database:backup Create a database backup (with mysqldump) database:configure Database: Configure (write local.php) database:install Clean Tiki install database:patch Apply a specific database schema patch database:update Update the database to the latest schema dev dev:configure Install or update development files dev:fixbom Fix BOM and line endings for all files faker faker:comments Generate comments fake data faker:tracker Generate tracker fake data files files:batchupload Batch upload files into the file galleries files:check Detect orphan or extra files files:copy Copy files from file galleries to a regular directory on the file system files:deleteold Remove expired files which were uploaded using the deleteAfter option files:index Index files files:move Move files from file galleries to a regular directory on the file system gallery gallery:migrate Migrate images from the Image Gallery to the File Gallery goal goal:check Reviews all active goals and assigns rewards. index index:catch-up Catch-up on incremental indexing. index:compare-engines Compare search engine results in wikiplugins index:optimize Optimize the unified search index index:rebuild Fully rebuild the unified search index installer installer:lock Disable the installer list list:execute Performs Plugin ListExecute command on a particular page mail-in mail-in:poll Read the mail-in messages mail-queue mail-queue:send Send the messages stored in the Mail Queue ml ml:train Train a particular machine learning model multitiki multitiki:list List MultiTikis in a path multitiki:move Moves a MultiTiki site from one tiki instance to another notification notification:digest Send out email notification digests objects objects:notify-maintainers Send out email notification to maintainers for objects whose freshness is greater than the limit package package:clearcache Deletes all content from Composer's cache directories. package:disable Disable a Tiki Package package:enable Enable a Tiki Package package:install Install package package:list List installed/available to install packages package:remove Remove package package:update Update package plugin plugin:approve Approve a list of plugin invocations/calls plugin:list List all plugin invocations/calls plugin:refresh Parses all the pages to refresh the list of plugin invocations/calls preferences preferences:delete Delete a preference preferences:export Export preferences preferences:get Get a preference preferences:rebuild-index Fully rebuild the preferences index preferences:set Set a preference profile profile:apply Apply a profile profile:baseline Generate the SQL patch to assign profile symbols for an existing installation. profile:export:init Initialize profile export for current site. profile:forget Forget a profile installation recommendation recommendation:batch Identify and send recommendations rss rss:clear Clear incoming RSS feed cache rss:refresh Refresh incoming RSS feeds scheduler scheduler:heal Heal scheduled tasks scheduler:run Run scheduled tasks scss scss:compile Compile SCSS theme files into CSS sitemap sitemap:generate Generate sitemap theme theme:install Install a new theme theme:remove Remove a theme theme:update Update a theme tiki tiki:info Displays the Tiki and/or PHP version tiki:stats Display a table with the KPIs tokens tokens:clear Remove expired tokens tracker tracker:clear Clear all items from a tracker without warning or notifications. Use with care! tracker:export Export a CSV file from a tracker using a tracker tabular format tracker:import Import a CSV file into a tracker using a tracker tabular format or initiate an ODBC import tracker:recalc Recalculate all math fields items from a tracker translation translation:englishupdate Fix English strings after modifying them. translation:export Update language.php translations from the database translation:getstrings Update language.php files with new strings translation:percentage Get the translation percentage for each language.php file users users:create Create a new user users:list Display the list of users in the system users:password Set the password to a given user users:remove-cookies Remove expired cookies users:unlock Unlock a user vcs vcs:automerge Semi Auto Merge vcs:fixids Fix the Id's of SVN Keyword for all files vcs:update Update Tiki to latest version & perform tasks for a smooth update.


If you want to learn the inner workings, source code is here: https://gitlab.com/tikiwiki/tiki/-/tree/21.x/lib/core/Tiki/Command

Copy to clipboard
[root@ html]# php console.php Tiki Console Tool Usage: command [options] [arguments] Options: -h, --help Display this help message -q, --quiet Do not output any message -V, --version Display this application version --ansi Force ANSI output --no-ansi Disable ANSI output -n, --no-interaction Do not ask any interactive question --site=SITE Multi-Tiki instance --as-user=AS-USER Run the command as a different Tiki user -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug Available commands: help Displays help for a command list Lists commands patch Apply a specific database schema patch backup backup:files Create a backup of Tiki instance files cache cache:clear Clear Tiki caches cache:generate Generate Tiki caches daily-report daily-report:send Send daily user reports database database:backup Create a database backup (with mysqldump) database:configure Database: Configure (write local.php) database:install Clean Tiki install database:redact Redact database database:update Update the database to the latest schema dev dev:fixbom Fix BOM and line endings for all files faker faker:comments Generate comments fake data faker:tracker Generate tracker fake data files files:batchupload Batch upload files into the file galleries files:check Detect orphan or extra files files:copy Copy files from file galleries to a regular directory on the file system files:deleteold Remove expired files which were uploaded using the deleteAfter option files:move Move files from file galleries to a regular directory on the file system gallery gallery:migrate Migrate images from the Image Gallery to the File Gallery goal goal:check Reviews all active goals and assigns rewards. index index:catch-up Catch-up on incremental indexing. index:optimize Optimize the unified search index index:rebuild Fully rebuild the unified search index installer installer:lock Disable the installer list list:execute Performs Plugin ListExecute command on a particular page mail-in mail-in:poll Read the mail-in messages mail-queue mail-queue:send Send the messages stored in the Mail Queue multitiki multitiki:list List MultiTikis in a path multitiki:move Moves a MultiTiki site from one tiki instance to another notification notification:digest Send out email notification digests objects objects:notify-maintainers Send out email notification to maintainers for objects whose freshness is greater than the limit ocr ocr:all OCR all queued files ocr:file Attempt to OCR a file. Defaults to queued OCR job ocr:set Set the OCR status of files (Queue, Skip) ocr:status Give statistics on file OCR status (Queued, Processing, Finished, Skipped) package package:clearcache Deletes all content from Composer's cache directories. package:disable Disable a Tiki Package package:enable Enable a Tiki Package package:install Install package package:list List installed/available to install packages package:remove Remove package package:update Update package plugin plugin:approve Approve a list of plugin invocations/calls plugin:list List all plugin invocations/calls plugin:refresh Parses all the pages to refresh the list of plugin invocations/calls preferences preferences:delete Delete a preference preferences:export Export preferences preferences:get Get a preference preferences:rebuild-index Fully rebuild the preferences index preferences:set Set a preference profile profile:apply Apply a profile profile:baseline Generate the SQL patch to assign profile symbols for an existing installation. profile:export:init Initialize profile export for current site. profile:forget Forget a profile installation recommendation recommendation:batch Identify and send recommendations rss rss:clear Clear incoming RSS feed cache rss:refresh Refresh incoming RSS feeds scheduler scheduler:heal Heal scheduled tasks scheduler:run Run scheduled tasks scss scss:compile Compile SCSS theme files into CSS sitemap sitemap:generate Generate sitemap theme theme:install Install a new theme theme:remove Remove a theme theme:update Update a theme tiki tiki:info Displays the Tiki and/or PHP version tiki:stats Display a table with the KPIs tracker tracker:clear Clear all items from a tracker without warning or notifications. Use with care! tracker:export Export a CSV file from a tracker using a tracker tabular format tracker:import Import a CSV file into a tracker using a tracker tabular format translation translation:englishupdate Fix English strings after modifying them. translation:getstrings Update language.php files with new strings users users:list Display the list of users in the system users:password Set the password to a given user vcs vcs:automerge Semi Auto Merge vcs:fixids Fix the Id's of SVN Keyword for all files vcs:update Update SVN to latest version & perform tasks for a smooth update.

Note:
In case you want to use OCR(Optical Character Recognition) command, you should activate it on your preferences then, install `thiagoalessio/tesseract_ocr` and `media-alchemyst/media-alchemyst` packages otherwise it will show `unavailable` on CLI for each command description;
And vcs(Version Control SOftware) command is a support for svn subversion.


If you want to learn the inner workings, source code is here: https://gitlab.com/tikiwiki/tiki/-/tree/18.x/lib/core/Tiki/Command

Copy to clipboard
user@server:/www/tiki18$ php console.php Console Tool Usage: command [options] [arguments] Options: -h, --help Display this help message -q, --quiet Do not output any message -V, --version Display this application version --ansi Force ANSI output --no-ansi Disable ANSI output -n, --no-interaction Do not ask any interactive question --site=SITE Multi-Tiki instance --as-user=AS-USER Run the command as a different user -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug Available commands: help Displays help for a command list Lists commands patch Apply a specific database schema patch addon addon:install Apply profiles for addon addon:remove Remove objects created by addon profile creation addon:upgrade Upgrade profiles for addon to newer version backup backup:files Create a backup of Tiki instance files cache cache:clear Clear Tiki caches daily-report daily-report:send Send daily user reports database database:backup Create a database backup (with mysqldump) database:configure Database: Configure (write local.php) database:install Clean Tiki install database:redact Command not available database:update Update the database to the latest schema faker faker:tracker Generate tracker fake data files files:batchupload Batch upload files into the file galleries files:check Detect orphan or extra files files:copy Copy files from file galleries to a regular directory on the file system files:deleteold Remove expired files which were uploaded using the deleteAfter option files:move Move files from file galleries to a regular directory on the file system gallery gallery:migrate Migrate images from the Image Gallery to the File Gallery goal goal:check Reviews all active goals and assigns rewards. index index:catch-up Catch-up on incremental indexing. index:optimize Optimize the unified search index index:rebuild Fully rebuild the unified search index installer installer:lock Disable the installer less less:compile Compile LESS theme files into CSS list list:execute Performs Plugin ListExecute command on a particular page mail-in mail-in:poll Read the mail-in messages mail-queue mail-queue:send Send the messages stored in the Mail Queue multitiki multitiki:list List MultiTikis in a path multitiki:move Moves a MultiTiki site from one tiki instance to another notification notification:digest Send out email notification digests plugin plugin:approve Approve a list of plugin invocations/calls plugin:list List all plugin invocations/calls plugin:refresh Parses all the pages to refresh the list of plugin invocations/calls preferences preferences:delete Delete a preference preferences:get Get a preference preferences:rebuild-index Fully rebuild the preferences index preferences:set Set a preference profile profile:apply Apply a profile profile:baseline Generate the SQL patch to assign profile symbols for an existing installation. profile:export:init Initialize profile export for current site. profile:forget Forget a profile installation recommendation recommendation:batch Identify and send recommendations rss rss:clear Clear incoming RSS feed cache rss:refresh Refresh incoming RSS feeds scheduler scheduler:heal Heal scheduled tasks scheduler:run Run scheduled tasks sitemap sitemap:generate Generate sitemap tracker tracker:clear Clear all items from a tracker without warning or notifications. Use with care! tracker:import Import a CSV file into a tracker using a tracker tabular format users users:list Display the list of users in the system users:password Set the password to a given user




Examples

Below are some common examples of how to use the console. They are typically for a recent version (so if they don't work, it could be that your Tiki is too old)

Help on database update

Copy to clipboard
php console.php database:update --help

To mark an upgrade error as registered (so it will be ignored)

Copy to clipboard
php console.php database:update --auto-register

This is useful if you get database errors such as "Duplicate entry..." sometimes

Help on database install

Copy to clipboard
php console.php database:install --help

Translations

Copy to clipboard
translation:englishupdate Fix English strings after modifying them. translation:export Update language.php translations from the database translation:getstrings Update language.php files with new strings translation:percentage Get the translation percentage for each language.php file

Translation Update Examples

For example if you fix a typo in a string which is already translated, e.g. you fix "Setttings" to "Settings":

Fixing a typo in the original English string for all languages
Copy to clipboard
php console.php translation:englishupdate


It will update all languages without modifying the translated part (in case it was already translated), so e.g. in the French language.php it will fix this:

Copy to clipboard
"Setttings" => "Paramètres",


To this:

Copy to clipboard
"Settings" => "Paramètres",


Without the need to re-translate the string which had a typo in the English original again.

Parameters

You can use the following parameters with translation:getstrings

Copy to clipboard
[-l|--lang [LANG]] [--outputfiles] [--exclude [EXCLUDE]] [--include [INCLUDE]] [--basedir [BASEDIR]] [--filename [FILENAME]]

Getting string for a single language
Copy to clipboard
php console.php translation:getstrings --lang=en


Note: The basedir parameter is working only if it point to this or another Tiki root directory (will search for /lang/...)

Batch Upload

A console command for Batch Upload so you can set a scheduled batch upload cron task

Example command line usage
Copy to clipboard
# file according to sub-directory name and create missing galleries php console.php files:batchupload 1 --subdirToSubgal --createSubgals # file according using sub-directory with integer name into gallery with corresponding ID php console.php files:batchupload 1 --subdirToSubgal --subdirIntegerToSubgalId # set file user etc so apache can manage the files afterwards php console.php files:batchupload 1 --fileUser apache --fileGroup allusers --fileMode 0775 # upload files from a different directory php console.php files:batchupload 1 --filesPath /var/www/other/uploads # more help php console.php help files:batchupload

Plugin List Execute

Actions can be run in conjunction with PluginListExecute:

Copy to clipboard
php console.php list:execute "Page Name" "Action Name"


If you see this type of error message:

Copy to clipboard
[root@server]# php console.php list:execute "Batch Sync Users" "SyncUsersTrackers" Command not available at this stage. Complete required installation steps. [root@server]#


You may need to update the database schema first, with the usual:

Copy to clipboard
[root@server]# php console.php d:u

Wiki Plugin Approval

Copy to clipboard
plugin:approve plugin:list plugin:refresh

Disable the Installer

Disable the installer:

Copy to clipboard
php console.php installer:lock

Manage files from file galleries

Copy files from a gallery to a regular directory on the filesystem:

Copy to clipboard
php console.php files:copy 1 /tmp/dest/

Move files from a gallery to a regular directory on the filesystem:

Copy to clipboard
php console.php files:move 1 /tmp/dest/ --confirm

Clear Caches and options

All the cache
Copy to clipboard
php console.php c:c
All the cache
Copy to clipboard
php console.php c:c all
Help
Copy to clipboard
php console.php c:c help
Database cache
Copy to clipboard
php console.php c:c private
Modules cache
Copy to clipboard
php console.php c:c modules
Templates cache
Copy to clipboard
php console.php c:c templates
CSS and JS caches
Copy to clipboard
php console.php c:c public

Users commands

A few commands related to user management are available in the Tiki console.

Copy to clipboard
users users:create Create a new user users:list Display the list of users in the system users:password Set the password to a given user users:unlock Unlock a user

 Note
If you get Credentials file local.php not found. See http://doc.tiki.org/Installation for more information. message it means you are doing fresh install from command line and need to create the db/local.php file manually first or run the Installer via a web browser.


Getting advanced help

Console-capture-20130429113244-882-0.png

More advanced examples

See more advanced examples, where memory limit or execution timeout are raised, or rebuild is forced and logged, in this other page:

alias