fuascailtdev/inventory-plugin

A hosting infrastructure inventory tracker for OctoberCMS. Manage hosts, sites, clients and installs with relationship tracking and a Bootstrap dashboard overview.

Maintainers

Package info

github.com/ofthewildfire/inventory

Language:HTML

Type:october-plugin

pkg:composer/fuascailtdev/inventory-plugin

Transparency log

Statistics

Installs: 2

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-06-30 06:45 UTC

This package is auto-updated.

Last update: 2026-06-30 06:47:26 UTC


README

A hosting infrastructure inventory tracker for OctoberCMS. Keep track of your hosts, sites, clients, and software installs — all in one place, with relationship tracking and a backend dashboard overview.

Features

  • Hosts — Record servers and hosting environments with provider, IP address, type, monthly cost, and notes
  • Sites — Track domains/websites linked to a host and client, with status and parent site support
  • Clients — Manage client contact records linked to their sites
  • Installs — Log CMS/software installs per site and host, including version, admin URL, and status
  • Relationships — Full cross-linking between hosts, sites, clients, and installs
  • Backend Dashboard — Overview panel accessible from the OctoberCMS backend navigation

Requirements

Requirement Version
PHP >= 8.1
OctoberCMS v3 / v4
Composer >= 2.0

Installation

Via Composer (Packagist)

Run the following command from the root of your OctoberCMS project:

composer require fuascailtdev/inventory-plugin

Then run the database migrations:

php artisan october:migrate

The plugin will be installed to plugins/fuascailtdev/inventory and activated automatically.

Manual Installation

  1. Download or clone this repository into your OctoberCMS plugins directory:
git clone https://github.com/ofthewildfire/inventory plugins/fuascailtdev/inventory
  1. Run migrations:
php artisan october:migrate

Usage

Once installed, navigate to the OctoberCMS backend. A new Inventory Management menu item will appear in the left sidebar with the following sections:

Section Description
Dashboard Overview of your infrastructure
Hosts Add and manage hosting servers
Sites Track domains and their associated host and client
Clients Manage client contact records
Installs Log software installs per site or host
Plugin Guide In-app documentation

Recommended workflow

  1. Add your Clients first
  2. Add your Hosts (servers/providers), optionally linking to a paying client
  3. Add Sites (domains), linking each to a host and client
  4. Add Installs (e.g. OctoberCMS, WordPress), linking each to a site and host

Data Structure

Client
  └── Sites (hasMany)

Host
  ├── Sites (hasMany)
  ├── Installs (hasMany)
  └── PaidByClient (belongsTo Client)

Site
  ├── Host (belongsTo)
  ├── Client (belongsTo)
  └── Installs (hasMany)

Install
  ├── Site (belongsTo)
  └── Host (belongsTo)

Changelog

v1.0.1

  • Initial release
  • Hosts, Clients, Sites, and Installs management
  • Backend dashboard and navigation

License

MIT — see LICENSE for details.

Author

Fuascailtdevgithub.com/ofthewildfire