Download the PHP package phpinnacle/recens without Composer
On this page you can find all versions of the php package phpinnacle/recens. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phpinnacle/recens
More information about phpinnacle/recens
Files in phpinnacle/recens
Package recens
Short Description Per-user recent page history for Laravel Filament panels.
License MIT
Homepage https://github.com/phpinnacle/recens
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package recens
Recens for Filament
Recens records pages visited by each authenticated Filament user and renders a compact recent-items menu. Applications decide which pages are recorded and may customize the stored title, icon, group and URL.
Features
- Recent page history isolated by user, Filament panel and configured tenant.
- Pinned pages with stable ordering, protected from automatic pruning.
- Menu actions to pin, unpin, remove an entry and clear ordinary history.
- Panel render hook for displaying recent entries.
- Configurable icon, color and number of entries.
- Page-specific recorder callbacks and scoped recording.
- Automatic pruning with configurable retention.
- Optional database connection and tenancy.
Installation
Register and configure the plugin:
Use scopes() to limit recording to the intended page groups. Each panel owns its Recorder registrations, so callbacks remain separate when a long-lived application switches panels or handles another request. The recorder records matching Filament pages after navigation and ignores Livewire update requests. Recent::list() returns entries for the authenticated user of the current panel, using that panel's auth guard.
Publish phpinnacle-recens-config to set the user model, connection, tenancy and pruning behavior. When pruning is enabled, schedule Laravel's model:prune command.
Pins and history controls
The menu shows pinned pages first, in the order they were pinned. Revisiting or pinning an already pinned page does not move it. The star button pins or unpins a page; the remove button deletes that entry, including a pin. Visiting a removed page records it again.
limit(8) limits ordinary recent entries; all pinned pages appear above them. Clear history removes all ordinary entries in the current panel and tenant, including entries beyond the visible limit, and keeps pinned pages. Every menu action checks the authenticated user's ownership in the current panel and tenant. Guests cannot read or change history.
The model also exposes these operations for application code:
Resolve entries through Recent::forCurrentContext() before exposing model operations to users. Recent::forUser($userId) is available for explicit model queries; it filters only ownership, so callers handling panel or tenant boundaries must add those constraints or use Recent::forCurrentContext().
Identity, panels and tenancy
Recent::record(array $data) remains available. URLs are canonicalized by removing their query string, as before. Entry IDs include the user, panel, configured tenant and canonical URL; a repeat visit updates only that user's matching entry. Outside a current Filament panel, the model uses the default auth guard and the unassigned (null) panel.
When tenancy.model is configured, the active Filament tenant ID is stored and used for both reads and writes. If there is no active tenant, tenancy.default supplies the tenant ID. Configure the actual default identifier, and keep Filament's normal tenant access middleware enabled. The tenant_id column must already exist from the package's tenancy-enabled installation. Changing the tenancy schema of an existing installation requires an application migration.
Pruning excludes pinned entries and honors prune.enabled and prune.days. Schedule model:prune to prune old ordinary entries across users and panels.
Upgrading to 1.2
As of 1.2.1, fresh installations create panel_id and pinned_at in the initial migration. The package no longer ships the separate add_panel_and_pins_to_recent migration.
Existing installations with the pre-1.2 schema require an application migration before serving requests with the updated package. Republishing the initial migration does not update an existing table. The application migration must add the panel and pin columns and account for the old URL-only entry IDs and unknown original panels. Use the configured database connection and the application's normal maintenance deployment process.
Applications that already ran the 1.2.0 upgrade migration can retain it and their migrated data; no additional schema migration is required for 1.2.1.
Testing
Changelog and license
See MIT License.
All versions of recens with dependencies
filament/filament Version ^4.0|^5.0
spatie/laravel-package-tools Version ^1.92