1. Install - adamgreenough/nicholas GitHub Wiki

Recommended Specifications

  • PHP >= 7.2
  • mod_rewrite

Installing from release

Releases are pre-bundled with required dependencies for a drag and drop installation and do not require use of Composer on the command line.

  1. Simply download the latest release
  2. Extract the zip file
  3. Upload the contained files in to the directory you wish your blog to run from
  4. Edit config file as required (see: Config)

Installing from repo

If you download Nicholas from a development branch (master included) then you will need to install the required dependencies via Composer.

  1. Download repository
  2. Upload the contained files in to the directory you wish your blog to run from
  3. From this directory, run composer install via command line
  4. Edit config file as required (see: Config)

Config

There are a handful of basic configuration options available in config.php to get your blog going.

/* Environment Settings */
const BASE_URL = ''; // If your nick installation is not in the web root, enter your folder name here with no trailing slash (eg. /blog)
const POSTS_PER_PAGE = 10;

/* Front-end Options */
const USE_FRONTEND = true; // Use the front-end (true) or API-only (false)?
const FRONTEND_THEME = 'default'; // Front-end theme by directory name
const BLOG_DESCRIPTION = 'Welcome to my amazing blog powered by Nicholas'; // A short description of your blog
const BLOG_NAME = 'Nicholas Demo'; // The name of your blog

Running Nicholas from a sub-directory

If you are running Nicholas from a sub-directory (eg. yourdomain.com/blog/) then you must update the BASE_URL option to the directory name without a trailing slash (eg. const BASE_URL = '/blog';)

Upgrading

If you already use Nicholas and would like to upgrade to the latest version...

  1. Make a backup
  2. Download the latest release
  3. Re-upload new files EXCLUDING the /posts/, /themes/ and /plugins/ which should only contain your customised non-core files.