Custom Action requires selected entries + “Leave Page?” prompt when using Asset field in Action (solved)

[jensolafkoch]

I’ve run into two issues with a custom Action I’m building.

First issue;: Custom Action requires selected entries

The Action isn’t supposed to depend on selected entries — it triggers a global process that deletes all entries in a collection and replaces them with newly imported ones. It’s only meant to be available in one specific collection, so I restricted it to that.

Before restricting it, the Action showed up in the general menu (the three-dot dropdown, where you can also edit Collections and Blueprints), and I could trigger it without selecting anything.

But now, after limiting it to a specific collection, it only shows up if at least one entry is selected — even though it doesn’t operate on selected entries at all.

Is there any way to make a collection-specific Action available without requiring a selection?

Action code pls. see bottom.

Second issue: “Leave Page?” prompt when using Asset field in Action

This Action uses an Asset field to pick the file to import. That part works fine, but when I confirm the Action I always get the question after execution:

“Leave page or stay?”

It’s the same message you get when there are unsaved changes in an entry.

Claude Sonnet 4.5 claims this happens because using an Asset field sets a “dirty flag”. Sounds plausible, but I couldn’t find any official info on that.

Does anyone know if that’s actually the case — and more importantly, is there any way to prevent that while still using an Asset field?

That prompt would definitely confuse normal users.

Thanks in advance!

Action Code:

<?php

namespace App\Actions;

use App\Services\TmzImportService;
use Statamic\Actions\Action;
use Statamic\Facades\Asset;
use Statamic\Facades\AssetContainer;

class ImportTmzAction extends Action
{
    protected TmzImportService $importService;

    protected $dangerous = true;

    public function __construct()
    {

        $this->importService = new TmzImportService;
    }

    /**
     * The action title
     */
    public static function title()
    {

        return __('TMZ importieren');
    }

    /**
     * Visible in TMZ collection
     */
    public function visibleTo($item)
    {

        return $item instanceof \Statamic\Entries\Entry
            && $item->collection()->handle() === 'tmz';
    }

    /**
     * Visible when TMZ entries are selected
     */
    public function visibleToBulk($items)
    {

        if ($items->isEmpty()) {
            return false;
        }

        $firstItem = $items->first();

        return $firstItem instanceof \Statamic\Entries\Entry
            && $firstItem->collection()->handle() === 'tmz';
    }

    /**
     * Allow running without any selected items
     */
    public function authorize($user, $item)
    {

        return true;
    }

    /**
     * Return form fields for file selection
     */
    public function fieldItems()
    {

        return [
            'csv_file' => [
                'type' => 'assets',
                'display' => 'CSV-Datei',
                'instructions' => 'Suchen Sie entweder eine bereits vorhandene TMZ-CSV-Datei aus dem Asset-Container im Verzeichnis "tmz-files" aus oder laden Sie eine neue CSV-Datei hoch. WICHTIG: Nur CSV-Dateien (.csv) werden akzeptiert!',
                'container' => 'assets',
                'folder' => 'tmz-files',
                'max_files' => 1,
                'validate' => 'required',
            ],
        ];
    }

    /**
     * The confirmation message shown before running
     */
    public function confirmationText()
    {
        return 'Alle bestehenden TMZ-Einträge werden gelöscht und durch die importierten Daten ersetzt. Nach dem Import werden Sie zur Ergebnisseite weitergeleitet.';
    }

    /**
     * The button text
     */
    public function buttonText()
    {

        return 'TMZ importieren';
    }

    /**
     * Run the action
     */
    public function run($items, $values)
    {

        $assetPath = $values['csv_file'] ?? null;

        if (! $assetPath) {

            session()->put('tmz_import_result', [
                'success' => false,
                'message' => 'Keine Datei ausgewählt.',
            ]);

            return ['message' => 'Fehler - Weiterleitung...'];
        }

        // Get asset from container by path
        $container = AssetContainer::find('assets');

        if (! $container) {

            session()->put('tmz_import_result', [
                'success' => false,
                'message' => 'Assets-Container nicht gefunden.',
            ]);

            return ['message' => 'Fehler - Weiterleitung...'];
        }

        $asset = $container->asset($assetPath);

        if (! $asset) {

            session()->put('tmz_import_result', [
                'success' => false,
                'message' => 'Asset nicht gefunden: '.$assetPath,
            ]);

            return ['message' => 'Fehler - Weiterleitung...'];
        }

        // Get absolute path to asset
        $fullPath = $asset->resolvedPath();

        if (! file_exists($fullPath)) {

            session()->put('tmz_import_result', [
                'success' => false,
                'message' => 'Datei nicht gefunden: '.$fullPath,
            ]);

            return ['message' => 'Fehler - Weiterleitung...'];
        }

        // Validate file extension - only CSV allowed
        $extension = strtolower($asset->extension());

        if ($extension !== 'csv') {

            session()->put('tmz_import_result', [
                'success' => false,
                'message' => 'Ungültiger Dateityp! Es werden nur CSV-Dateien (.csv) akzeptiert. Die ausgewählte Datei hat die Endung .'.$extension,
            ]);

            return ['message' => 'Fehler - Weiterleitung...'];
        }

        // Run import
        $result = $this->importService->import($fullPath);

        if (! $result['success']) {

            session()->put('tmz_import_result', [
                'success' => false,
                'message' => $result['message'],
            ]);

            return ['message' => 'Fehler - Weiterleitung...'];
        }

        // Build success message
        $successMessage = $result['imported'].' Einträge erfolgreich importiert. '.$result['error_count'].' Zeilen übersprungen.';

        // Generate error report if there are errors
        if (! empty($result['errors'])) {

            // Get original filename from asset path
            $originalFilename = basename($assetPath);
            $errorReportFilename = $this->importService->generateErrorReport(
                $result['errors'],
                $originalFilename,
                $result['old_entries_deleted'] ?? false,
                $result['imported']
            );

            // Store result in session for redirect
            session()->put('tmz_import_result', [
                'success' => true,
                'has_errors' => true,
                'imported' => $result['imported'],
                'error_count' => $result['error_count'],
                'error_report' => $errorReportFilename,
                'old_entries_deleted' => $result['old_entries_deleted'] ?? false,
            ]);

            // Return message (will be ignored, but required)
            return ['message' => 'Import abgeschlossen - Weiterleitung...'];
        }

        // Store result in session for redirect
        session()->put('tmz_import_result', [
            'success' => true,
            'has_errors' => false,
            'imported' => $result['imported'],
            'skipped' => $result['error_count'],
        ]);

        // Return message (will be ignored, but required)
        return ['message' => 'Import erfolgreich - Weiterleitung...'];
    }

    /**
     * Redirect after action
     */
    public function redirect($items, $values)
    {

        // Redirect to result page
        return route('tmz-import.result');
    }
}

[jensolafkoch]

A bit later: Answering my own questions ...

I understand now that actions are always entry-dependent in terms of concept. The action is now available in every entry menu, even when not selected (check-boxed).

I was also able to get rid of the Leave Page dialog by adding a bypass for the dirty flag.