Download the PHP package vanilla/knowledge-porter without Composer
On this page you can find all versions of the php package vanilla/knowledge-porter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vanilla/knowledge-porter
More information about vanilla/knowledge-porter
Files in vanilla/knowledge-porter
Package knowledge-porter
Short Description A command line porter for Vanilla Knowledge
License
Informations about the package knowledge-porter
knowledge-porter
A command line porter for Vanilla Knowledge.
Example:
Where ./customer1.zendesk.json
is relative path to your configuration file.
Configuration file contains set of feature flags for porter to configure source and destination (data & api). Example:
Alternatively, you can set the porter configuration into an environmental variable and tell the porter to use the variable instead of the configuration file.
Example, assuming your configuration is set on the variable CONFIG:
Note: The environmental variable must contain a valid JSON configuration in the same way that a file configuration should be.
Rate Limit Bypass for Vanilla's Infrastructure
If the destination is type vanilla
, you might want to use the rate_limit_bypass_token
(optional) configuration parameter to set your rate limit bypass token.
Users and Authors
When porter import articles it is searching for existing user by email
and uses it if found.
If user is not found by email porter checks configuration feature flag syncUserByEmailOnly
and if that flag is false (dafault) search user by name
.
If user still can not be found porter will create new user.
Import from multiple domains
In case we need to import data from different domains and they all could be reached using same api credentials/token
there is another tool mulit-import.sh
.
This script get one argument which is folder name with special configuration file.
For example gink
.
That folder should have 2 files inside: template.json
and domains
.
template.json
is regular config json file for this porter. but with 2 special values prefix
and source-domain
:
and domains
file has very flat structure domain.com=prefix
like:
This bash script will:
- read
domains
and loop trough - get each domain and prefix value
- copy
template.json
to/conf
subfolder with new name. Eg:diamond.gink.com.json
- substitute
prefix
andsource-domain
in that new configuration file - run
knowledge-porter
command in background with this per domain prepared config
Example:
This multi-import
script starts many php processes in background (one process per domain).
We can check progress using various log files created by this tool in targeted {folder}/log
.
There is one special log file {folder}/log/import.log
.
It has PIDs of running php processes in case developer need to stop them or investigate any incident.
All versions of knowledge-porter with dependencies
ext-json Version *
vanilla/garden-cli Version ^4.0
vanilla/garden-container Version ^4.0
vanilla/garden-schema Version ^3.0
vanilla/garden-http Version ^2.1
psr/log Version ^3.0
psr/simple-cache Version *
symfony/cache Version ^6.2
ext-dom Version *
ext-mbstring Version *
ext-libxml Version *
ext-simplexml Version *