Notify Class Reference

Class to manage the table of subscription to notifications. More...

Collaboration diagram for Notify:

Public Member Functions
	__construct ($db)
	Constructor.
	confirmMessage ($action, $socid, $object)
	Return message that say how many notification (and to which email) will occurs on requested event.
	delete (User $user=null)
	Delete a notification from database.
	create (User $user=null, $notrigger=0)
	Create notification information record.
	fetch ($id, $socid=0, $type='email')
	Load record from database.
	update (User $user=null, $notrigger=-1)
	Update record in database.
	getNotificationsArray ($notifcode, $socid=0, $object=null, $userid=0, $scope=array('thirdparty', 'user', 'global'))
	Return number of notifications activated, for all or a given action code (and third party)
	send ($notifcode, $object, $filename_list=array(), $mimetype_list=array(), $mimefilename_list=array())
	Check if notification are active for couple action/company.

Detailed Description

Class to manage the table of subscription to notifications.

Definition at line 37 of file notify.class.php.

Constructor & Destructor Documentation

__construct()

Notify::__construct

(

$db

)

Constructor.

Parameters

DoliDB

$db

Database handler

Definition at line 159 of file notify.class.php.

Member Function Documentation

confirmMessage()

Notify::confirmMessage	(		$action,
			$socid,
			$object )

Return message that say how many notification (and to which email) will occurs on requested event.

This is to show confirmation messages before event is recorded.

Parameters

string	$action	Id of action in llx_c_action_trigger
int	$socid	Id of third party
Object	$object	Object the notification is about

Returns

string Message

Definition at line 174 of file notify.class.php.

References $object, getDolGlobalString(), getNotificationsArray(), and img_object().

create()

Notify::create	(	User	$user = null,
			$notrigger = 0 )

Create notification information record.

Parameters

User | null	$user	User
int	$notrigger	1=Disable triggers

Returns

int Return integer <0 if KO, > 0 if OK (ID of newly created company notification information)

Definition at line 285 of file notify.class.php.

References dol_now(), and type.

delete()

Notify::delete

(

User

$user = null

)

Delete a notification from database.

Parameters

User | null

$user

User deleting

Returns

int Return integer <0 if KO, >0 if OK

Definition at line 251 of file notify.class.php.

References dol_syslog().

fetch()

Notify::fetch	(		$id,
			$socid = 0,
			$type = 'email' )

Load record from database.

Parameters

int	$id	Id of record
int	$socid	Id of company. If this is filled, function will return only records belonging to this thirdparty
string	$type	If id of company filled, we say if we want record of this type only

Returns

int Return integer <0 if KO, >0 if OK

Definition at line 336 of file notify.class.php.

References dol_print_error(), and type.

getNotificationsArray()

Notify::getNotificationsArray	(		$notifcode,
			$socid = 0,
			$object = null,
			$userid = 0,
			$scope = array('thirdparty', 'user', 'global') )

Return number of notifications activated, for all or a given action code (and third party)

Parameters

string	$notifcode	Code of action in llx_c_action_trigger (new usage) or Id of action in llx_c_action_trigger (old usage)
int	$socid	Id of third party or 0 for all thirdparties or -1 for no thirdparties
Object	$object	Object the notification is about (need it to check threshold value of some notifications)
int	$userid	Id of user or 0 for all users or -1 for no users
array	$scope	Scope where to search

Returns

array|int Return integer <0 if KO, array of notifications to send if OK

Definition at line 440 of file notify.class.php.

References $object, dol_syslog(), and isValidEmail().

Referenced by confirmMessage().

send()

Notify::send	(		$notifcode,
			$object,
			$filename_list = array(),
			$mimetype_list = array(),
			$mimefilename_list = array() )

Check if notification are active for couple action/company.

If yes, send mail and save trace into llx_notify.

Parameters

string	$notifcode	Code of action in llx_c_action_trigger (new usage) or Id of action in llx_c_action_trigger (old usage)
Object	$object	Object the notification deals on
array	$filename_list	List of files to attach (full path of filename on file system)
array	$mimetype_list	List of MIME type of attached files
array	$mimefilename_list	List of attached file name in message

Returns

int Return integer <0 if KO, or number of changes if OK

Definition at line 609 of file notify.class.php.

References $object, complete_substitutions_array(), dol_getIdFromCode(), dol_is_file(), dol_now(), dol_print_error(), dol_sanitizeFileName(), dol_strlen(), dol_syslog(), dolGetFirstLastname(), get_exdir(), getCommonSubstitutionArray(), getDolGlobalString(), and make_substitutions().

update()

Notify::update	(	User	$user = null,
			$notrigger = -1 )

Update record in database.

Parameters

User | null	$user	Object user
int	$notrigger	1=Disable triggers

Returns

int Return integer <=0 if KO, >0 if OK

Definition at line 387 of file notify.class.php.

References type.

---

The documentation for this class was generated from the following file:

• dolibarr_20.0/htdocs/core/class/notify.class.php