Files
IPB/applications/calendar/extensions/core/Notifications/Events.php
T
2025-12-19 19:04:57 -08:00

232 lines
8.3 KiB
PHP

<?php
/**
* @brief Notification Options
* @author <a href='https://www.invisioncommunity.com'>Invision Power Services, Inc.</a>
* @copyright (c) Invision Power Services, Inc.
* @license https://www.invisioncommunity.com/legal/standards/
* @package Invision Community
* @since 20 May 2016
*/
namespace IPS\calendar\extensions\core\Notifications;
/* To prevent PHP errors (extending class does not exist) revealing path */
use IPS\calendar\Event;
use IPS\Extensions\NotificationsAbstract;
use IPS\Lang;
use IPS\Member;
use IPS\Notification\Inline;
use OutOfRangeException;
use function defined;
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( $_SERVER['SERVER_PROTOCOL'] ?? 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
/**
* Notification Options
*/
class Events extends NotificationsAbstract
{
/**
* Get fields for configuration
*
* @param Member|null $member The member (to take out any notification types a given member will never see) or NULL if this is for the ACP
* @return array
*/
public static function configurationOptions( Member $member = NULL ): array
{
$return = array(
'event_reminder' => array(
'type' => 'standard',
'notificationTypes' => array( 'event_reminder' ),
'title' => 'notifications__calendar_Reminders',
'showTitle' => true,
'description' => 'notifications__calendar_Reminders_desc',
'default' => array( 'inline', 'push', 'email' ),
'disabled' => array()
)
);
/* Can we create events? */
if( $member === null or Event::canCreate( $member ) )
{
$return['event_rsvp'] = array(
'type' => 'standard',
'notificationTypes' => array( 'event_rsvp' ),
'title' => 'notifications__calendar_Rsvp',
'showTitle' => true,
'description' => 'notifications__calendar_Rsvp_desc',
'default' => array( 'inline', 'push', 'email' ),
'disabled' => array()
);
}
return $return;
}
/**
* Parse notification: new_content
*
* @param Inline $notification The notification
* @param bool $htmlEscape TRUE to escape HTML in title
* @return array
* @code
return array(
'title' => "Mark has replied to A Topic", // The notification title
'url' => new \IPS\Http\Url( ... ), // The URL the notification should link to
'content' => "Lorem ipsum dolar sit", // [Optional] Any appropriate content. Do not format this like an email where the text
// explains what the notification is about - just include any appropriate content.
// For example, if the notification is about a post, set this as the body of the post.
'author' => \IPS\Member::load( 1 ), // [Optional] The user whose photo should be displayed for this notification
);
* @endcode
*/
public function parse_new_content( Inline $notification, bool $htmlEscape=TRUE ): array
{
$item = $notification->item;
if ( !$item )
{
throw new OutOfRangeException;
}
$name = ( $item->isAnonymous() ) ? Member::loggedIn()->language()->addToStack( 'post_anonymously_placename' ) : $item->author()->name;
return array(
'title' => Member::loggedIn()->language()->addToStack( 'notification__new_content', FALSE, array(
( $htmlEscape ? 'sprintf' : 'htmlsprintf' ) => array(
$name,
mb_strtolower( $item->indefiniteArticle() ),
$item->container()->getTitleForLanguage( Member::loggedIn()->language(), $htmlEscape ? array( 'escape' => TRUE ) : array() ),
$item->mapped('title')
)
) ),
'url' => $notification->item->url(),
'content' => $notification->item->content(),
'author' => $notification->item->author(),
'unread' => (bool) ( $item->unread() )
);
}
/**
* Parse notification: Event reminder
*
* @param Inline $notification The notification
* @param bool $htmlEscape TRUE to escape HTML in title
* @return array
* @code
* return array(
* 'title' => "Mark has replied to A Topic", // The notification title
* 'url' => new \IPS\Http\Url( ... ), // The URL the notification should link to
* 'content' => "Lorem ipsum dolar sit", // [Optional] Any appropriate content. Do not format this like an email where the text
* // explains what the notification is about - just include any appropriate content.
* // For example, if the notification is about a post, set this as the body of the post.
* 'author' => \IPS\Member::load( 1 ), // [Optional] The user whose photo should be displayed for this notification
* );
* @endcode
*/
public function parse_event_reminder( Inline $notification, bool $htmlEscape=TRUE ): array
{
$item = $notification->item;
if ( !$item )
{
throw new OutOfRangeException;
}
return array(
'title' => Member::loggedIn()->language()->addToStack( 'notification__event_reminder', FALSE, array(
( $htmlEscape ? 'sprintf' : 'htmlsprintf' ) => array( Member::loggedIn()->language()->addToStack( "days_to_go", FALSE, array( 'pluralize' => array( $notification->extra['daysToGo'] ) ) ), $item->mapped('title') )
) ),
'url' => $notification->item->url(),
'content' => $notification->item->content(),
'author' => $notification->item->author(),
'unread' => (bool) ( $item->unread() )
);
}
/**
* Parse notification for mobile: event_reminder
*
* @param Lang $language The language that the notification should be in
* @param Event $event The event the notification refers to
* @param int $daysToGo
* @return array
*/
public static function parse_mobile_event_reminder( Lang $language, Event $event, int $daysToGo ): array
{
return array(
'title' => $language->addToStack( 'notification__event_reminder_title', FALSE, array(
'pluralize' => array(1)
) ),
'body' => $language->addToStack( 'notification__event_reminder', FALSE, array( 'htmlsprintf' => array(
$language->addToStack( "days_to_go", FALSE, array( 'pluralize' => array(
$daysToGo
) ) ),
$event->mapped('title')
) ) ),
'data' => array(
'url' => (string) $event->url(),
'author' => $event->author(),
),
'channelId' => 'events',
);
}
/**
* Parse notification: Event RSVPs
*
* @param Inline $notification The notification
* @param bool $htmlEscape TRUE to escape HTML in title
* @return array
* @code
* return array(
* 'title' => "Mark has replied to A Topic", // The notification title
* 'url' => new \IPS\Http\Url( ... ), // The URL the notification should link to
* 'content' => "Lorem ipsum dolar sit", // [Optional] Any appropriate content. Do not format this like an email where the text
* // explains what the notification is about - just include any appropriate content.
* // For example, if the notification is about a post, set this as the body of the post.
* 'author' => \IPS\Member::load( 1 ), // [Optional] The user whose photo should be displayed for this notification
* );
* @endcode
*/
public function parse_event_rsvp( Inline $notification, bool $htmlEscape=TRUE ): array
{
$item = $notification->item;
if ( !$item )
{
throw new OutOfRangeException;
}
$member = Member::load( $notification->extra['member'] );
return array(
'title' => Member::loggedIn()->language()->addToStack( 'notification__event_rsvp', FALSE, array( 'sprintf' => array( $member->name, $item->mapped( 'title' ) ) ) ),
'url' => $notification->item->url(),
'author' => $member
);
}
/**
* Parse notification for mobile: event_reminder
*
* @param Lang $language The language that the notification should be in
* @param Event $event The event the notification refers to
* @param Member $member The member who RSVPd
* @return array
*/
public static function parse_mobile_event_rsvp( Lang $language, Event $event, Member $member ): array
{
return array(
'title' => $language->addToStack( 'notification__event_rsvp_title' ),
'body' => $language->addToStack( 'notification__event_rsvp', FALSE, array( 'sprintf' => array( $member->name, $event->mapped('title') ) ) ),
'data' => array(
'url' => (string) $event->url(),
'author' => $member
),
'channelId' => 'events',
);
}
}