Hooks Reference — Fundorex

Hook System Overview

Fundorex provides a comprehensive hook system for plugins to interact with core functionality without modifying core code. Hooks are divided into actions (do something) and filters (modify something).

Action Hooks

Actions allow plugins to trigger custom code at specific points in the application lifecycle.

Action Syntax

do_action('hook_name', $param1, $param2);

Available Action Hooks

Core Application Hooks

Hook	Parameters	Description	Timing
`fundorex:app.booted`	none	Application has finished bootstrapping	After core initialization
`fundorex:app.shutdown`	none	Application is shutting down	Before application exit
`fundorex:cache.cleared`	none	Cache has been cleared	After cache flush

User & Authentication Hooks

Hook	Parameters	Description	Timing
`fundorex:user.created`	`$user`	User account created	After user creation
`fundorex:user.updated`	`$user`, `$oldUser`	User profile updated	After profile update
`fundorex:user.deleted`	`$userId`	User account deleted	After user deletion
`fundorex:auth.login`	`$user`, `$remember`	User logged in	After successful login
`fundorex:auth.logout`	`$user`	User logged out	After logout

Campaign Hooks

Hook	Parameters	Description	Timing
`fundorex:campaign.created`	`$campaign`	Campaign created	After campaign creation
`fundorex:campaign.updated`	`$campaign`, `$oldCampaign`	Campaign updated	After campaign update
`fundorex:campaign.published`	`$campaign`	Campaign published	When campaign goes live
`fundorex:campaign.closed`	`$campaign`	Campaign closed	When campaign ends
`fundorex:campaign.deleted`	`$campaignId`	Campaign deleted	After campaign deletion

Contribution Hooks

Hook	Parameters	Description	Timing
`fundorex:contribution.created`	`$contribution`, `$campaign`	Contribution received	After successful payment
`fundorex:contribution.processed`	`$contribution`	Contribution processed	After processing completes
`fundorex:contribution.refunded`	`$contribution`	Contribution refunded	After refund

Admin Hooks

Hook	Parameters	Description	Timing
`fundorex:admin.dashboard.render`	`$dashboard`	Admin dashboard rendering	Before dashboard display
`fundorex:settings.saved`	`$settings`, `$oldSettings`	Settings updated	After settings save

Using Action Hooks

<?php

namespace MyVendor\MyPlugin;

use Illuminate\Support\ServiceProvider;

class PluginServiceProvider extends ServiceProvider
{
    public function boot()
    {
        // Listen to user creation
        add_action('fundorex:user.created', function($user) {
            Log::info('New user: ' . $user->email);
            // Send welcome email, assign default role, etc.
        });

        // Listen to campaign publication
        add_action('fundorex:campaign.published', function($campaign) {
            // Notify followers
            $campaign->notifyFollowers('Campaign published!');
        });
    }
}

Filter Hooks

Filters allow plugins to modify data before it's used.

Filter Syntax

$value = apply_filters('hook_name', $value, $param1, $param2);

Available Filter Hooks

Display Filters

Hook	Parameters	Return	Description
`fundorex:campaign.description`	`$description`, `$campaign`	string	Campaign description text
`fundorex:campaign.title`	`$title`, `$campaign`	string	Campaign title
`fundorex:user.display_name`	`$name`, `$user`	string	User display name
`fundorex:email.subject`	`$subject`, `$type`	string	Email subject line
`fundorex:email.body`	`$body`, `$type`, `$context`	string	Email body content

Data Validation Filters

Hook	Parameters	Return	Description
`fundorex:campaign.validate`	`$campaign`, `$rules`	array	Campaign validation rules
`fundorex:user.validate`	`$user`, `$rules`	array	User validation rules
`fundorex:contribution.validate`	`$contribution`, `$rules`	array	Contribution validation rules

Query Filters

Hook	Parameters	Return	Description
`fundorex:campaigns.query`	`$query`	Query	Campaign query builder
`fundorex:users.query`	`$query`	Query	User query builder
`fundorex:contributions.query`	`$query`	Query	Contribution query builder

Permission Filters

Hook	Parameters	Return	Description
`fundorex:user.can`	`$can`, `$user`, `$ability`, `$resource`	bool	User ability check
`fundorex:permission.check`	`$allowed`, `$user`, `$permission`	bool	Permission verification

Using Filter Hooks

<?php

namespace MyVendor\MyPlugin;

use Illuminate\Support\ServiceProvider;

class PluginServiceProvider extends ServiceProvider
{
    public function boot()
    {
        // Modify campaign description
        add_filter('fundorex:campaign.description', function($description, $campaign) {
            // Add campaign status badge
            $status = strtoupper($campaign->status);
            return $description . ' [' . $status . ']';
        }, 10, 2);

        // Add validation rule
        add_filter('fundorex:campaign.validate', function($rules, $campaign) {
            $rules['minimum_goal'] = 'required|numeric|min:100';
            return $rules;
        }, 10, 2);

        // Extend campaign query
        add_filter('fundorex:campaigns.query', function($query) {
            // Only published campaigns by default
            return $query->where('status', 'published');
        });
    }
}

Hook Priority

Control hook execution order with priority parameter (default: 10, lower = earlier):

add_action('fundorex:campaign.published', $callback, 5); // Runs first
add_action('fundorex:campaign.published', $callback, 10); // Runs second
add_action('fundorex:campaign.published', $callback, 15); // Runs third

Removing Hooks

Remove a previously registered hook:

remove_action('fundorex:campaign.published', 'plugin_callback_function', 10);
remove_filter('fundorex:campaign.title', 'plugin_filter_function', 10);

Hook Naming Convention

Actions: fundorex:{entity}.{event} (e.g., fundorex:campaign.published)
Filters: fundorex:{entity}.{property} (e.g., fundorex:campaign.title)

Deprecated Hooks

Note: This hooks reference reflects the current version. Hooks may change between versions. Always check Menus, Assets & Routes and Permissions, Settings & Data documentation for related integration points.

Next Steps

Menus, Assets & Routes — UI menu integration
Permissions, Settings & Data — Data and permissions

Still stuck?

Our support team is ready to help you get set up.

Get support