Landing Page

Configure and customize the public landing page for your PteroCA panel

New in v0.6.3

Overview

The landing page is the public-facing homepage of your PteroCA panel, designed to showcase your products and attract customers. It provides a modern, customizable interface for visitors to browse your offerings before logging in.

Key Features

• Featured Categories - Highlight your most popular product categories

• Featured Products - Showcase specific products you want to promote

• Widget System - Add custom content blocks and promotional sections

• Separate Theme - Use a different theme for landing vs panel

• Custom Navigation - Add custom buttons to the navigation bar

• Responsive Design - Mobile-friendly layout out of the box

Landing Page Routes

PteroCA provides two landing page routes:

• Homepage (/) - Displays featured categories and products

• Store Page (/store) - Shows all categories with their products

---

Enabling the Landing Page

The landing page can be enabled or disabled in General Settings.

Quick Start

1. Navigate to Admin Panel → Settings → General

2. Find Landing Page Enabled setting

3. Toggle to enable or disable

4. Save changes

When enabled:

• Root URL (/) shows the public landing page

• Unauthenticated visitors can browse products and categories

• /store route provides full product catalog

• Great for public hosting businesses and marketing

When disabled:

• Root URL (/) redirects to login page

• Only authenticated users can access the panel

• Traditional panel-only behavior (pre-v0.6.3)

• Ideal for private/internal use or when using external marketing site

Detailed Configuration

For complete documentation on the Landing Page Enabled setting including use cases, security considerations, and best practices, see General Settings - Landing Page Enabled.

---

Featured Items

Featured items appear on the homepage with priority positioning.

Featured Categories

Featured categories appear in the "Featured Categories" section on the homepage.

To feature a category:

1. Navigate to Admin Panel → Categories

2. Edit a category

3. Enable Featured checkbox

4. Set Priority (higher numbers appear first)

5. Add an attractive Image for visual appeal

6. Save changes

Display rules:

• Maximum 6 featured categories shown on homepage

• Sorted by priority (DESC), then by name

• Only non-deleted categories appear

• Image recommended for best presentation

Featured Products

Featured products appear in the "Featured Products" section on the homepage.

To feature a product:

1. Navigate to Admin Panel → Products

2. Edit a product

3. Enable Featured checkbox

4. Set Priority (higher numbers appear first)

5. Add a Banner Image for visual appeal

6. Ensure product is Active and Not Deleted

7. Save changes

Display rules:

• Maximum 6 featured products shown on homepage

• Sorted by priority (DESC), then by name

• Only active, non-deleted products appear

• Banner image recommended for best presentation

Priority System

Both categories and products use a priority field to determine display order:

• Higher values appear first

• Equal priorities sorted alphabetically by name

• Default priority is 0

• Range: Any integer (can be negative)

Example:

Product A (priority: 100) → Shown first
Product B (priority: 50)  → Shown second
Product C (priority: 50)  → Shown third (alphabetically after B)
Product D (priority: 0)   → Shown last

---

Widget System

Widgets allow you to add custom content blocks to the landing page.

Widget Contexts

Landing page supports two widget contexts:

• LANDING_HOMEPAGE - Homepage (/) widgets

• LANDING_STORE - Store page (/store) widgets

Adding Widgets via Plugins

Plugins can register widgets that appear on landing pages. See Plugin Development - Widgets for details.

Example widget uses:

• Promotional banners

• Trust badges and testimonials

• Latest news or announcements

• Social media feeds

• Custom HTML content blocks

---

Customization

Theme Customization

Use a different theme for the landing page:

1. Navigate to Settings → Theme

2. Set Landing Theme (LANDING_THEME) to your preferred theme

3. Theme must support "landing" context in its template.json

4. Save changes

See Themes for more information.

Custom Navigation Buttons

Add custom buttons to the landing page navigation bar using events:

use App\Core\Event\Landing\NavigationButtonsCollectedEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class CustomNavigationSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            NavigationButtonsCollectedEvent::class => 'onNavigationButtons',
        ];
    }

    public function onNavigationButtons(NavigationButtonsCollectedEvent $event): void
    {
        // Add custom button
        $event->addButton([
            'label' => 'Documentation',
            'url' => 'https://docs.example.com',
            'icon' => 'fa-book',
        ]);
    }
}

Available Events

Landing page fires events for customization:

• LandingPageAccessedEvent - Page accessed

• LandingPageDataLoadedEvent - Data loaded (categories/products)

• NavigationButtonsCollectedEvent - Navigation buttons collection

• WidgetsCollectedEvent - Widgets collection

See Event System for details.

---

Best Practices

Images and Visuals

Categories:

• Use consistent image dimensions (recommended: 400×300px)

• High-quality images that represent the category

• Optimize file sizes for fast loading

Products:

• Add banner images for featured products

• Use product screenshots or promotional graphics

• Maintain consistent aspect ratios

Featured Item Selection

Categories:

• Feature your most popular or profitable categories

• Limit to 6 or fewer for clean homepage

• Update seasonally or based on promotions

Products:

• Highlight new or promotional products

• Balance between variety and focus

• Test different featured products to optimize conversions

Performance

• Keep featured items count reasonable (6 or fewer)

• Optimize images (compress, use appropriate formats)

• Minimize custom widgets on landing page

• Use caching for widget content

SEO Considerations

• Add descriptive category and product descriptions

• Use meaningful product names

• Ensure landing page loads quickly

• Consider adding meta tags via theme customization

---

Troubleshooting

Landing Page Not Showing

Check:

1. LANDING_PAGE_ENABLED setting is true

2. Active theme supports "landing" context

3. Cache cleared after enabling: php bin/console cache:clear

No Featured Items Showing

Check:

1. Items have Featured checkbox enabled

2. Items are Active and Not Deleted

3. Category/product has proper Priority value

4. Images are uploaded and accessible

Theme Issues

If landing page displays incorrectly:

1. Verify theme has "landing" in contexts array

2. Check theme has landing/ directory with templates

3. Fall back to default theme if custom theme broken

4. Review theme error logs

---

Related Documentation

• Themes - Theme management and customization

• Products - Product configuration

• Categories - Category management

• Event System - Landing page events

• Widget Development - Creating custom widgets