static_content_browser

Static Content Browser - Drupal.org Project Page Content

Use this content for the Drupal.org project page at https://www.drupal.org/project/static_content_browser

Project Short Description

File management interface for Static Content Type module directories. Browse, upload, edit, and manage static HTML content without SFTP access.

Project Full Description

What is Static Content Browser?

Static Content Browser is a companion module for Static Content Type that provides a complete file management interface within Drupal's admin UI. It empowers content creators to manage static HTML microsites, landing pages, and custom content—all without requiring SFTP access or technical server knowledge.

Think of it as a built-in file manager specifically designed for your static content directories.

Why Static Content Browser?

The Challenge

The Static Content Type module enables powerful static HTML content integration in Drupal, but managing those files traditionally requires:

• SFTP client software
• Server credentials
• Technical knowledge of file systems
• Manual coordination outside Drupal

This creates friction for content teams and security concerns for administrators.

The Solution

Static Content Browser brings file management inside Drupal where it belongs:

Traditional Workflow With Static Content Browser Open SFTP client Click "Static Content Browser" Enter credentials Already authenticated via Drupal Navigate directories Visual folder navigation Upload files manually Drag-and-drop uploads Edit with external tools Built-in WYSIWYG editor No permission control Drupal permission integration

Key Features

Browser Interface

A familiar, intuitive file browser with directory navigation, breadcrumbs, and file listings.

Six content directories at a glance

Drag-and-Drop Uploads

Upload files instantly by dragging them onto the drop zone. No forms, no waiting.

Upload files with a simple drag and drop

Built-in File Editor

Edit HTML, CSS, JavaScript, JSON, and more with the integrated WYSIWYG editor. No external tools needed.

Edit files directly in your browser

Directory Downloads

Download entire directories as ZIP archives with one click—perfect for backups or sharing.

Smart Navigation

• Breadcrumb trail shows your exact location
• Arrow navigation moves between sibling directories
• "View index.html" button previews the active page

Security Built-in

• CSRF protection on all operations
• Drupal permission integration
• Path traversal prevention
• File type validation

How It Works

1. Install & Configure

<span class="hljs-symbol">composer</span> <span class="hljs-meta">require</span> drupal/static_content_browser
<span class="hljs-symbol">drush</span> en static_content_browser

2. Set Permissions

Grant "View static content browser" and "Edit static content files" to appropriate roles.

3. Start Managing

Navigate to Administration > Content > Static Content Browser and you're ready to go.

Directory Structure

Static Content Browser manages six content directories:

Directory Purpose static-content-nodes Content for node entities static-content-blocks Content for block entities static-content-paragraphs Content for paragraph entities static-content-sdc Single Directory Components static-content-twig Twig template content static-content-pages Standalone static pages

Each directory can contain subdirectories organized by entity ID or custom identifiers, with support for special build directories (dist, build, src, etc.).

Use Cases

Marketing Teams

Upload and manage landing pages, campaign microsites, and promotional content without developer assistance.

Design Agencies

Deliver static HTML prototypes directly into the Drupal file system for client review and iteration.

Documentation Teams

Maintain static documentation sites with easy updates through the browser interface.

Development Workflows

Manage build artifacts from static site generators, with the browser providing a visual interface for the output.

Requirements

• Drupal: 10.x, 11.x, or 12.x
• PHP: 8.1+
• Optional: PHP ZipArchive extension for directory downloads

Related Modules

• Static Content Type - Required companion module that displays static HTML content as Drupal entities

Getting Started

1. Install both Static Content Type and Static Content Browser
2. Configure permissions for your content roles
3. Create your first static content entity
4. Use the browser to upload and manage your HTML files

See the full documentation for detailed setup instructions and feature guides.

Support & Contributing

• Issue Queue: Report bugs and request features
• Documentation: Comprehensive guides and API reference
• Contributing: Pull requests welcome on the project repository

Screenshots Section

Upload these screenshots to the Drupal.org project page:

Screenshot 1: Top-Level Browser

Caption: "The top-level browser shows all six content directory types with visual folder icons."
Alt text: "Static Content Browser top-level view showing six folder icons for nodes, blocks, paragraphs, SDC, twig, and pages directories"

Screenshot 2: Directory Browser

Caption: "Browse files and subdirectories with navigation arrows, drag-and-drop uploads, and quick actions."
Alt text: "Directory browser interface showing file listing, navigation arrows, drop zone for uploads, and action buttons"

Screenshot 3: File Editor

Caption: "Edit HTML, CSS, JavaScript and other text files with the built-in WYSIWYG editor."
Alt text: "File editor interface showing code editing with syntax highlighting and save buttons"

Categories/Tags for Drupal.org

Categories:

• Content
• File Management
• Administration

Tags:

• static content
• file browser
• file manager
• HTML content
• content management
• file upload
• WYSIWYG editor

Composer/Packagist Info

Package name: drupal/static_content_browser

Description: File management interface for Static Content Type module directories.

Last updated: December 2024