Events

I tried a couple of existing plugin solutions most did 95% of what I needed and the other 5% was next to impossible to force.

After wasting days I decided I would write my own, what follows is an overview of Tentacle event API.

Contact me if you have any questions.

Registering an event:

[sourcecode language="php"]
function method_one (){
echo ‘one ‘;
}

function method_two (){
echo ‘two ‘;
}

event::on(‘event_trigger’, ‘method_one’, 2);
event::on(‘event_trigger’, ‘method_two’, 1);

event::trigger(‘event_trigger’);
[/sourcecode]

Turning events off:

[sourcecode language="php"]event::off(‘event_trigger’);

event::off(‘event_trigger’, ‘method_two’);

event::off(null, ‘method_one’);[/sourcecode]

Test if an event exists:

[sourcecode language="php"]var_dump(event::exists(‘event_trigger’));
[/sourcecode]
boolean true

Trigger an event:

[sourcecode language="php"]function method_name ( )
{
echo ‘my method name’;
}

event::on(‘event_name’, ‘method_name’);

event::trigger(‘event_name’);[/sourcecode]
my method name

Trigger an event and pass data to it:

[sourcecode language="php"]function method_data ( $text = ” )
{
echo ‘ 1 my method data is ‘.$text;
}

function method_data_two ( $text = ” )
{
echo ‘ 2 my method data is ‘.$text;
}

event::on(‘event_data’, ‘method_data’, 1);
event::on(‘event_data’, ‘method_data_two’, 2);

event::trigger(‘event_data’, ‘this’);[/sourcecode]
1 my method data is this 2 my method data is this

Triggering a class and passing data to the method

[sourcecode language="php"]class my
{
static function method_name ( $text = ” )
{
echo ‘my class method name is ‘.$text;
}
}

event::on(‘event_class’, ‘my::method_name’);

event::trigger(‘event_class’, ‘Lary’);[/sourcecode]
my class method name is Lary

Event chaining

[sourcecode language="php"]function method_sad ( $text = ” )
{
return str_replace(‘blah’, "sad", $text);
}

function method_happy ( $text = ” )
{
return str_replace(‘sad’, "happy", $text);
}

event::on(‘event_mood’, ‘method_sad’, 1);
event::on(‘event_mood’, ‘method_happy’, 2);

echo event::filter(‘event_mood’, ‘I am blah!’);
[/sourcecode]
I am happy!