Download the PHP package fklavyenet/webblocks-cms without Composer

WebBlocks CMS

WebBlocks CMS is a Laravel-native, block-based CMS for multisite content operations. It adds structured pages, media, navigation, editorial workflows, and an operator admin under /webadmin to a host Laravel application.

[!IMPORTANT] This repository is Composer package source, not a complete deployable Laravel application. Install fklavyenet/webblocks-cms into a host Laravel 13 application; the host continues to own its bootstrap, .env, database, queues, mail, deployment, backups, and public document root.

The operator dashboard brings publishing state, common actions, recent pages, and media into one package-owned admin.

What WebBlocks CMS provides

• Block-based publishing — reusable page layouts, slots, nested blocks, drafts, review, publishing, revisions, and restore.
• Multisite and localization — multiple sites, domains, locales, translated content, and site-scoped navigation and presentation.
• Media management — a shared Media Library, responsive image variants, focal-point-aware crops, metadata, folders, and usage guards.
• Reusable content — Shared Slots, navigation trees, block catalogs, and package-owned public renderers built on WebBlocks UI classes.
• Operator workflows — users and permissions, search, contact messages, engagement, backups, site transfer, cloning, and package-native updates.
• Trusted automation APIs — capability-scoped Internal Content APIs for discovery, validation, draft-first page building, media, and publishing workflows.
• Static package assets — no Node, npm, Vite, or frontend build chain is required by the CMS package.

The Pages listing combines site and status filters with publishing state, block counts, previews, and page actions.

Requirements

• PHP ^8.4
• Laravel Framework ^13.0
• Composer 2
• PHP extensions: mbstring, sodium, and zip
• A database supported by the host Laravel application
• Optional: GD for CMS image and media transformations

The supported ranges come from composer.json. CI runs the package suite, a current Laravel 13 consumer installation, a Laravel 13.0.* resolution-floor check, distribution validation, and documentation checks.

Installation

Start with a fresh or existing Laravel 13 host whose application key and database are configured. The normal host App\Models\User model must exist and be writable during initial CMS setup.

Laravel discovers WebBlocks\Cms\WebBlocksCmsServiceProvider through the package manifest. The idempotent install command:

• publishes missing CMS configuration and static assets;
• patches the host User model with CMS access behavior;
• removes only Laravel's untouched welcome route;
• installs the package-owned schema and required Laravel support tables;
• prepares storage and seeds the core CMS catalog; and
• creates the first site and super administrator.

Review Laravel coexistence.

Host integration

The host remains the application boundary. It owns authentication decisions outside the CMS, environment configuration, database connectivity, scheduled work, mail and queue drivers, deployment, and backups. WebBlocks CMS uses the host User identity and adds CMS membership and role authorization; host product administrators are not automatically CMS administrators.

After installation, open /webadmin. Package-owned CMS authentication uses /webadmin/login unless the host intentionally supplies an integrated authentication flow. /cms is reserved for published static assets and is not an admin prefix.

Configuration and assets

The package supports these publish tags:

Views, translations, and migrations load from the installed package and do not have separate publish tags. Avoid --force unless you intentionally want to replace package-owned published files in a controlled host environment.

CMS static assets are published under public/cms. Site-owned overrides belong under public/site/{site_handle} in the host application. See media image variants.

Package development

This repository is directly package-rooted. For package development:

Additional package checks are available as composer test:consumer, composer test:dist, composer test:docs, and composer test:floor. See package testing strategy.

Upgrading

WebBlocks CMS 1.37.0 is the first release tagged from the package-only repository root. The package identity remains fklavyenet/webblocks-cms; the repository transition does not turn this source tree into a standalone Laravel application.

Existing full-repository clones must preserve host-owned .env, database, storage, uploads, plugins, project content, application files, and public overrides. Do not pull the package-only tree across a historical full-application checkout. Follow UPGRADING.md for Composer, legacy clone, source-maintained, and Publisher/System Updates topologies.

Documentation

• Start with Core Concepts.
• Build content with Revisions.
• Operate sites with Operations.
• Integrate trusted tools through the AI Page Building Guide.
• Understand runtime boundaries in Updates.

Security

Do not disclose vulnerabilities in public issues. Follow security guide for host hardening, authorization, token, upload, and update-integrity boundaries.

Contributing and support

Contributions are welcome through SUPPORT.md explains support boundaries and the distinction between public support and private security reports.

Acknowledgements

WebBlocks CMS is designed, directed, and maintained by Osman Bozdağ.

Development has been supported with AI-assisted engineering, primarily through OpenAI ChatGPT, with limited contributions from Anthropic Claude.

License

WebBlocks CMS is open-source software licensed under the MIT License.