README

Testa is a Galician term used in printing and binding referring to the top edge of a book.

It is also a comprehensive Laravel package that extends the Lunar e-commerce platform. Testa offers an opinionated, feature-rich solution specifically designed for building advanced, content-driven online stores for bookshops.

This package is tailored for bookshops that utilize Geslib as their primary management system. It relies on the numaxlab/lunar-geslib package for the core Geslib integration and complements it by providing a ready-to-use storefront implementation.

Furthermore, Testa expands Lunar's capabilities by integrating a full-featured educational platform, a membership system, news and events management, and other key tools.

Testa was designed in a collaboration between Traficantes de Sueños, Katakrak and NUMAX.

Features

• Content Management: Create and manage static pages, promotional banners, and image slides.
• Education Platform:
  • Manage courses, modules, and topics.
  • Dedicated "Course" product type in Lunar.
• Media Library:
  • Upload and manage Audio, Video, and Document files.
  • Control media visibility (e.g., public, members-only).
• Membership System:
  • Define membership tiers and plans.
  • Manage subscriptions and member-exclusive benefits.
• News & Events:
  • Publish articles.
  • Create and manage events with types and venues.
• Editorial Area: Manage reviews and special "editorial" collections.
• Donation System: Includes a pre-configured, flexible "Donation" product type.
• Lunar & Filament Integration:
  • Extends core Lunar models like Product and Customer.
  • Extends the Filament admin panel for Product and Customer resources.
• Provides a rich set of Livewire and Blade components for the storefront.

Requirements

• PHP ^8.4
• Laravel 12
• LunarPHP
• Lunar Geslib

Installation

Note: Testa is currently in beta. To install a beta release, set minimum-stability to beta (or dev with prefer-stable: true) in your host app's composer.json.

After following the official Laravel installation instructions to create a new project, you can install this package via Composer:

composer require numaxlab/testa:^1.0@beta

The package service provider will be auto-discovered by Laravel.

1. Add the Filament Plugins to the Lunar Panel in the register method of your AppServiceProvider

   LunarPanel::panel(function ($panel) {
        return $panel
            ->plugins([
                GeslibPlugin::make(),
                TestaPlugin::make(),
                ShippingPlugin::make(),
                SpatieLaravelTranslatablePlugin::make()
                    ->defaultLocales(['es', 'en']), // Setup the languages you want to use
            ]);
   })->register();

2. Run the Installer Commands

   This is a crucial step. The installer commands will set up required Lunar attributes, collection groups, tags, and seed initial data needed for the package to function correctly.

   php artisan lunar:geslib:install
   php artisan lunar:testa:install

Configuration

First check the lunar-geslib documentation and review the installation and configuration steps. As noted there, a queue configuration is important for being able to import Geslib data.

The configuration file for this package will be available at config/testa.php. Review all items and adjust the values to fit your specific setup.

Testing

The package uses Pest for testing. You can run the tests using the following command:

composer test

Or

./vendor/bin/pest

Contributing

Please see CONTRIBUTING.md for details.

License

The MIT License (MIT). Please see License File for more information.

Authors

• Adrián Pardellas Blunier (adrian@numax.org)
• X. Carlos Hidalgo (carlos@numax.org)