not_pressed-core 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d2c847504c7b5020949675becc86c826e4e775dd38cccc5812f1ab80197b07c7
+  data.tar.gz: 82315be6116a3a33d7c21b7b4c8ed155bd6cf0b71dcd044f64c7824614db6514
+SHA512:
+  metadata.gz: 728c1a3cfe4ec9cb7025194b0dd944b03ea80db01287c7f30fc13e7dadde234a825c32d765e477ba51a7caaab9289929bc8170b1e397ba79c5bc03d4c31c6204
+  data.tar.gz: c1873a495fec9800e6c3ce260874e719c206a8a451710f59241e13e2273602e0e76cfeaf1ce35d3c55b425f91f9bee91a7755dcdf266a0eb2bf56a169c414214

data/LICENSE.txt

@@ -0,0 +1,41 @@
+The NotPressed License (NPL-1.0)
+
+Copyright (c) 2026 NotPressed Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+1. The above copyright notice and this permission notice shall be included in
+   all copies or substantial portions of the Software.
+
+2. PLUGIN DISTRIBUTION CLAUSE: Any plugin, extension, theme, or add-on that
+   integrates with the Software's plugin interface and is distributed publicly
+   (i.e., made available to third parties outside the developer's own
+   organization) must be made available free of charge. Public plugins may be
+   open source or closed source, but may not require payment, subscription,
+   licensing fees, or any other form of monetary compensation for their use.
+
+   This clause does NOT restrict:
+   (a) Private plugins developed for internal use within an organization;
+   (b) Custom development services (building, modifying, or configuring the
+       Software or plugins for clients);
+   (c) Selling, bundling, or redistributing the Software itself as part of a
+       product, service, or hosted offering;
+   (d) Accepting voluntary donations or sponsorships for plugin development.
+
+3. TRADEMARK CLAUSE: The name "NotPressed", the NotPressed logo, and
+   associated branding may not be used in derivative works, forks, or
+   products in a manner that suggests official endorsement or affiliation
+   without prior written permission from the copyright holders.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,285 @@
+# not\_pressed-core
+
+The core engine behind [NotPressed](https://github.com/notpressed/not_pressed) — a drop-in, fully open-source CMS for Rails 8. Auto-discovers your app's navigation, provides a block-based content editor, and supports plugins and themes — all without the WordPress tax.
+
+**Not WordPress. Not pressed for cash. Not pressed for time.**
+
+## Why not\_pressed-core?
+
+Most CMS options force you to either adopt a monolithic platform (WordPress, Strapi) or bolt on a headless CMS that doesn't understand your Rails app. not\_pressed-core takes a different approach: it's a Rails engine that lives *inside* your existing application, works with your routes and views, and stays out of your way.
+
+- **3 commands to a working CMS** — install the gem, run the generator, migrate
+- **Works with your app** — auto-discovers routes, partials, and navigation from your existing codebase
+- **Zero external JS** — built entirely on Hotwire, Turbo, and Stimulus
+- **Batteries included** — pages, blog, media library, block editor, forms, SEO, themes, plugin system
+- **Extensible** — plugin architecture, custom content types, theme system, import/export
+
+## Requirements
+
+- Ruby >= 3.2
+- Rails >= 8.0
+- Active Storage (for media library)
+
+## Installation
+
+Add not\_pressed-core to your Gemfile:
+
+```ruby
+gem "not_pressed-core"
+```
+
+Run the install generator:
+
+```bash
+bundle install
+rails generate not_pressed:install
+rails db:migrate
+```
+
+Optionally load sample content:
+
+```bash
+rails runner "load 'db/seeds/not_pressed.rb'"
+```
+
+Visit `/not_pressed` to access the admin panel.
+
+## Features
+
+### Block-Based Page Editor
+
+Build pages from ordered, typed content blocks with a drag-and-drop editor:
+
+| Block Type | Description |
+|------------|-------------|
+| `text` | Rich text paragraph |
+| `heading` | Section heading (h1-h6) |
+| `image` | Image with caption and alt text |
+| `video` | Embedded video |
+| `code` | Syntax-highlighted code block |
+| `quote` | Blockquote with attribution |
+| `divider` | Visual separator |
+| `html` | Raw HTML injection |
+| `form` | Embedded form (from form builder) |
+| `gallery` | Image grid with lightbox viewer |
+| `callout` | Highlighted callout box (plugin) |
+
+Custom block types can be added via the plugin system.
+
+### Page Management
+
+- Hierarchical page tree with drag-to-reorder
+- Draft / published / scheduled / archived workflow
+- Page duplication, version history
+- SEO fields, layout selection, visibility controls
+- Live preview with split/toggle pane
+
+### Blog
+
+Built-in blog with categories, tags, and RSS:
+
+- Blog posts are pages with the `blog_post` content type
+- Category and tag management in admin
+- Public blog listing with pagination
+- Category and tag filtering
+- Year/month archives
+- RSS 2.0 feed at `/blog/feed.rss`
+
+### Media Library
+
+Centralized media management backed by Active Storage:
+
+- Upload, browse, search, and filter
+- Automatic metadata extraction (dimensions, file size, content type)
+- Alt text and title fields for accessibility and SEO
+- Image variants and thumbnail generation
+- Media picker modal for the block editor
+
+### Forms
+
+Drag-and-drop form builder with submissions:
+
+- Field types: text, email, textarea, select, checkbox, radio, number, date, phone, url
+- Submission management with CSV export
+- Email notifications on submission
+- Embeddable via the `form` block type
+
+### SEO & Discoverability
+
+- Per-page meta title, description, Open Graph, Twitter Cards
+- Canonical URLs and robots meta directives
+- Auto-generated XML sitemap at `/sitemap.xml`
+- Configurable `robots.txt`
+- Per-page and global JS/CSS code injection
+
+### Navigation
+
+not\_pressed-core builds navigation automatically using three layers:
+
+1. **Config DSL** — explicitly defined menus
+2. **Route introspection** — scans your Rails routes for navigable pages
+3. **Partial parsing** — detects existing nav/menu/header partials in your views
+
+## Configuration
+
+The install generator creates `config/initializers/not_pressed.rb`:
+
+```ruby
+NotPressed.configure do |config|
+  # Site name displayed in the admin header
+  config.site_name = "My Site"
+
+  # Admin panel mount path (default: "not_pressed")
+  config.admin_path = "admin"
+
+  # Records per page in admin listings
+  config.per_page = 25
+
+  # Authentication — Devise method, custom Proc, or nil (no auth)
+  config.admin_authentication = :authenticate_admin_user!
+  config.admin_current_user = :current_admin_user
+  config.admin_unauthorized_redirect = "/login"
+
+  # Available layouts for pages
+  config.available_layouts = %w[default sidebar full_width]
+
+  # Default theme
+  config.default_theme = "Starter"
+
+  # Auto-discover navigation from routes and view partials
+  config.auto_discover_navigation = true
+  config.cache_navigation = true
+
+  # SEO title separator
+  config.seo_title_separator = " | "
+
+  # Global code injection (head/body)
+  config.global_head_code = ""
+  config.global_body_code = ""
+
+  # Navigation DSL
+  config.menus do |menu|
+    menu.add "Home", "/"
+    menu.add "Blog", "/blog"
+    menu.add "About", "/about"
+  end
+end
+```
+
+### Authentication
+
+not\_pressed-core doesn't ship its own auth — it plugs into yours:
+
+```ruby
+# Devise
+config.admin_authentication = :authenticate_admin_user!
+
+# Custom logic
+config.admin_authentication = ->(controller) {
+  controller.redirect_to "/login" unless controller.session[:admin]
+}
+
+# No auth (development only!)
+config.admin_authentication = nil
+```
+
+## Extending NotPressed
+
+### Custom Content Types
+
+Define custom content types with the builder DSL:
+
+```ruby
+NotPressed.define_content_type(:event) do
+  label "Event"
+  icon "calendar"
+  description "An event with date and location"
+  allowed_blocks :text, :heading, :image
+  has_slug true
+  has_parent false
+
+  field :event_date, :datetime, label: "Event Date", required: true
+  field :venue, :string, label: "Venue"
+  field :ticket_url, :url, label: "Ticket URL"
+end
+```
+
+### Plugins
+
+WordPress-style plugin system with hooks, filters, custom blocks, and admin extensions:
+
+```ruby
+class MyPlugin < NotPressed::Plugin
+  name "my_plugin"
+  version "1.0.0"
+  description "Does something useful"
+
+  on(:after_page_save) { |page| Rails.logger.info "Saved: #{page.title}" }
+
+  block_type :callout
+
+  settings do
+    field :api_key, :string, label: "API Key"
+  end
+
+  admin_menu label: "My Plugin", icon: "puzzle-piece"
+
+  routes do
+    get "my-plugin", to: "my_plugin#index"
+  end
+end
+```
+
+Plugins can be exported as `.zip` archives and imported on other installations via the admin panel.
+
+See [Plugin Development Guide](docs/guides/plugin-development.md) for full documentation.
+
+### Themes
+
+Swappable themes with layouts, color schemes, and template overrides:
+
+```ruby
+class MyTheme < NotPressed::Theme
+  name "my_theme"
+  version "1.0.0"
+
+  layout :default, label: "Default", primary: true
+  layout :sidebar, label: "With Sidebar"
+
+  stylesheet "not_pressed/themes/my_theme"
+
+  color_scheme do
+    color :primary, "#3366cc", label: "Primary"
+    color :background, "#ffffff", label: "Background"
+    color :text, "#333333", label: "Text"
+  end
+end
+```
+
+Themes support color customization from the admin panel, template overrides via view path prepending, and can be exported/imported as `.zip` archives.
+
+See [Theme Development Guide](docs/guides/theme-development.md) for full documentation.
+
+## Development
+
+After checking out the repo:
+
+```bash
+bundle install
+cd spec/dummy && rails db:create db:migrate && cd ../..
+bundle exec rspec
+```
+
+The test suite uses a Rails 8 dummy app in `spec/dummy/`.
+
+### Documentation
+
+- [Plugin Development Guide](docs/guides/plugin-development.md)
+- [Theme Development Guide](docs/guides/theme-development.md)
+- [Hooks & Filters Reference](docs/guides/hooks-reference.md)
+- [CSS Variables Reference](docs/guides/css-variables-reference.md)
+- [API Reference](docs/api-reference.md)
+
+## License
+
+not\_pressed-core is released under the [NPL-1.0 License](LICENSE.txt).

data/app/assets/javascripts/not_pressed/lightbox.js

@@ -0,0 +1,110 @@
+/**
+ * NotPressed Gallery Lightbox
+ *
+ * Auto-initializes on elements with data-controller="lightbox"
+ * or class "np-content-gallery". Provides click-to-open, keyboard
+ * navigation (left/right arrows, Escape), and overlay click to close.
+ */
+(function () {
+  "use strict";
+
+  function initLightbox(gallery) {
+    var images = gallery.querySelectorAll(".np-gallery-item img");
+    if (!images.length) return;
+
+    var currentIndex = 0;
+    var overlay = null;
+    var lightboxImg = null;
+
+    function createOverlay() {
+      overlay = document.createElement("div");
+      overlay.className = "np-lightbox-overlay";
+      overlay.setAttribute("hidden", "");
+
+      lightboxImg = document.createElement("img");
+      lightboxImg.className = "np-lightbox-image";
+
+      var closeBtn = document.createElement("button");
+      closeBtn.className = "np-lightbox-close";
+      closeBtn.textContent = "\u00d7";
+      closeBtn.setAttribute("aria-label", "Close lightbox");
+
+      var prevBtn = document.createElement("button");
+      prevBtn.className = "np-lightbox-nav np-lightbox-nav--prev";
+      prevBtn.textContent = "\u2039";
+      prevBtn.setAttribute("aria-label", "Previous image");
+
+      var nextBtn = document.createElement("button");
+      nextBtn.className = "np-lightbox-nav np-lightbox-nav--next";
+      nextBtn.textContent = "\u203a";
+      nextBtn.setAttribute("aria-label", "Next image");
+
+      overlay.appendChild(closeBtn);
+      overlay.appendChild(prevBtn);
+      overlay.appendChild(lightboxImg);
+      overlay.appendChild(nextBtn);
+      document.body.appendChild(overlay);
+
+      closeBtn.addEventListener("click", close);
+      prevBtn.addEventListener("click", prev);
+      nextBtn.addEventListener("click", next);
+      overlay.addEventListener("click", function (e) {
+        if (e.target === overlay) close();
+      });
+    }
+
+    function show(index) {
+      if (!overlay) createOverlay();
+      currentIndex = index;
+      lightboxImg.src = images[currentIndex].src;
+      lightboxImg.alt = images[currentIndex].alt || "";
+      overlay.removeAttribute("hidden");
+      document.addEventListener("keydown", onKeydown);
+    }
+
+    function close() {
+      if (overlay) {
+        overlay.setAttribute("hidden", "");
+        document.removeEventListener("keydown", onKeydown);
+      }
+    }
+
+    function prev() {
+      currentIndex = (currentIndex - 1 + images.length) % images.length;
+      lightboxImg.src = images[currentIndex].src;
+      lightboxImg.alt = images[currentIndex].alt || "";
+    }
+
+    function next() {
+      currentIndex = (currentIndex + 1) % images.length;
+      lightboxImg.src = images[currentIndex].src;
+      lightboxImg.alt = images[currentIndex].alt || "";
+    }
+
+    function onKeydown(e) {
+      if (e.key === "Escape") close();
+      else if (e.key === "ArrowLeft") prev();
+      else if (e.key === "ArrowRight") next();
+    }
+
+    images.forEach(function (img, idx) {
+      img.style.cursor = "pointer";
+      img.addEventListener("click", function () {
+        show(idx);
+      });
+    });
+  }
+
+  function init() {
+    var galleries = document.querySelectorAll(
+      '.np-content-gallery, [data-controller="lightbox"]'
+    );
+    galleries.forEach(initLightbox);
+  }
+
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", init);
+  } else {
+    init();
+  }
+})();