@pantheon-systems/cpub-cli

CLI

Content Publisher Toolkit

Content Publisher toolkit for setting up projects.

Installation

npm

npm install @pantheon-systems/cpub-cli --global

yarn

yarn add @pantheon-systems/cpub-cli --global

Usage

# Login the user
$ cpub login

# Create project with nextjs template
$ cpub init new_proj

# Create project using pnpm package manager
$ cpub init new_proj --use-pnpm

# Create Typescript project and setup ESLint in it
$ cpub init new_proj --ts --eslint

# Create project without installing dependencies
$ cpub init new_proj --noInstall

# Create project and provide site ID to pre-populate .env file with
$ cpub init new_proj --site-id 123456789example1234

# Create new token
$ cpub token create

# Create new site
$ cpub site create --url test-site.com

# Get webhooks event delivery logs for a site ID
$ cpub site webhooks history 123456789example1234

# Generate preview link for given document ID
$ cpub document preview 1234567890example1234567890exam_ple123456789

# Generate preview link for given document URL
$ cpub document preview https://docs.google.com/document/d/1234567890example1234567890exam_ple123456789

# Get details of logged-in user
$ cpub whoami

# Logout the user
$ cpub logout

Import existing content from a Drupal site

You must ensure that the JSON API for your Drupal site is enabled (which it should be by default). https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module/api-overview

Once you've ensured that it's working, you will need to determine the URL which Content Publisher client can use to get the initial results page of posts (e.g. https://example.com/jsonapi/node/article). But please note that the exact URL will depend on which resource type(s) you want to import.

The second and last piece of information you will need before proceeding to import, is the id of the Content Publisher collection which the posts should be imported into. Posts are NOT going to be published automatically after importing, but they will be automatically connected to the site id provided.

With this information, you can now run the import command.

$ pcc import drupal https://example.com/jsonapi/node/article siteid12345