studioespresso/craftnet-cp

Basic craft net integration with a CP interface

1.3.0 2019-03-04 18:29 UTC

This package is auto-updated.

Last update: 2024-11-05 07:44:05 UTC


README

Basic craftnet integration with a CP interface and command line tools.

Note that I made this mostly for myself and that future development will take place if and when I need it. Issues and PR's will be handled on a best-effort basis.

Requirements

This plugin requires Craft CMS 3.0.0-beta.23 or later.

Installation

To install the plugin, follow these instructions.

  1. Open your terminal and go to your Craft project:

     cd /path/to/project
    
  2. Then tell Composer to load the plugin:

     composer require studioespresso/craftnet-cp
    
  3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Craftnet CP.

Configuring Craftnet CP

You can manage the following settings in your craftnet-cp.php file:

  • username (optional, also available as setting in CP)

  • token (optional, also available as setting in CP)

  • plugins (required, contains handle => label for each of your plugins.)

  • displayNotes (optional, displays notes below plugin license info)

    'you@myawesomeplugins.com', 'token' => '5tmukfu4x2ld8xm1619oJy8klw17fvDsXsDDft8nk' 'plugins' => [ 'plugin-handle' => 'Plugin Label', ], 'displayNotes' => true ];

Console Commands

You can add licenses individually or in bulk from the command line.

craftnet-cp/license/generate

// Generate a single license
./craft craftnet-cp/license/generate --email=customer@company.com --plugin=my-plugin-handle 

// Generate a single license with more details
./craft craftnet-cp/license/generate --email=customer@company.com --plugin=my-plugin-handle --edition=free --expirable=true --notes="Things to note." --privateNotes="Things to note."

// Generate multiple licenses
./craft craftnet-cp/license/generate --email=customer@company.com --plugin=my-plugin-handle --count=3
  • The edition attribute defaults to standard
  • The expirable attribute defaults to false
  • The count attribute defaults to 1

craftnet-cp/license/import-csv

Add licenses in bulk via a CSV file.

./craft craftnet-cp/license/import-csv --file="/path/to/file.csv"

CSV files can include the following column headers:

  • plugin
  • email
  • count
  • edition
  • expirable
  • notes
  • privateNotes

Functionality

  • Generate one or more licenses for a plugin
  • List all sold and generated licenses

Brought to you by Studio Espresso