ILIAS  release_5-1 Revision 5.0.0-5477-g43f3e3fab5f
ilMailFormCall Class Reference

Statically used helper class for generating links to the mail form user interface. More...

+ Collaboration diagram for ilMailFormCall:

Static Public Member Functions

static getLinkTarget ($gui, $cmd, Array $gui_params=array(), Array $mail_params=array(), $context_params=array())
 
static getRedirectTarget ($gui, $cmd, array $gui_params=array(), array $mail_params=array(), array $context_params=array())
 
static storeReferer ($request_params)
 
static getSignature ()
 Get preset signature. More...
 
static getRefererRedirectUrl ()
 
static isRefererStored ()
 
static getContextId ()
 
static setContextId ($id)
 
static getContextParameters ()
 
static setContextParameters (array $parameters)
 
static setRecipients (array $recipients)
 
static getRecipients ()
 

Data Fields

const SESSION_KEY = 'mail_transport'
 
const REFERER_KEY = 'r'
 HTTP-GET parameter for the referer url. More...
 
const SIGNATURE_KEY = 'sig'
 Session parameter for the hash. More...
 
const CONTEXT_PREFIX = 'ctx'
 Session parameter for the context. More...
 
const CONTEXT_KEY = 'ctx_template'
 Session parameter for the context. More...
 

Detailed Description

Statically used helper class for generating links to the mail form user interface.

Version
: $Id$
Author
Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de

Definition at line 10 of file class.ilMailFormCall.php.

Member Function Documentation

◆ getContextId()

static ilMailFormCall::getContextId ( )
static
Returns
string|null

Definition at line 216 of file class.ilMailFormCall.php.

217 {
218 $session = ilSession::get(self::SESSION_KEY);
219 return (
220 isset($session[self::CONTEXT_PREFIX][self::CONTEXT_KEY]) &&
221 strlen($session[self::CONTEXT_PREFIX][self::CONTEXT_KEY]) ?
222 $session[self::CONTEXT_PREFIX][self::CONTEXT_KEY] : NULL
223 );
224 }
static get($a_var)
Get a value.

References ilSession\get().

Referenced by ilMailFormGUI\editAttachments(), ilMail\replacePlaceholders(), ilMailFormGUI\saveDraft(), and ilMailFormGUI\searchUsers().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getContextParameters()

static ilMailFormCall::getContextParameters ( )
static
Returns
array context parameters

Definition at line 239 of file class.ilMailFormCall.php.

240 {
241 $session = ilSession::get(self::SESSION_KEY);
242 if(isset($session[self::CONTEXT_PREFIX]))
243 {
244 return (array)$session[self::CONTEXT_PREFIX];
245 }
246 return array();
247 }
const CONTEXT_PREFIX
Session parameter for the context.

References CONTEXT_PREFIX, and ilSession\get().

Referenced by ilMailFormGUI\editAttachments(), ilMail\replacePlaceholders(), ilMailFormGUI\saveDraft(), and ilMailFormGUI\searchUsers().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getLinkTarget()

static ilMailFormCall::getLinkTarget (   $gui,
  $cmd,
Array  $gui_params = array(),
Array  $mail_params = array(),
  $context_params = array() 
)
static
Parameters
mixed$gui
string$cmd
array$gui_params
array$mail_params
array$context_params
Returns
string

Definition at line 46 of file class.ilMailFormCall.php.

47 {
48 return self::getTargetUrl('&', $gui, $cmd, $gui_params, $mail_params, $context_params);
49 }
$cmd
Definition: sahs_server.php:35

References $cmd.

Referenced by ilAwarenessMailFeatureProvider\collectFeaturesForTargetUser(), ilUsersOnlineBlockGUI\fillRow(), ilAssignedUsersTableGUI\fillRow(), ilPublicUserProfileGUI\getEmbeddable(), ilObjCourseGUI\infoScreen(), and ilPaymentTrusteeGUI\showTrustees().

+ Here is the caller graph for this function:

◆ getRecipients()

static ilMailFormCall::getRecipients ( )
static
Returns
array

Definition at line 273 of file class.ilMailFormCall.php.

274 {
275 $session = ilSession::get(self::SESSION_KEY);
276 return (array)$session['rcp_to'];
277 }

References ilSession\get().

Referenced by ilMailGUI\executeCommand().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getRedirectTarget()

static ilMailFormCall::getRedirectTarget (   $gui,
  $cmd,
array  $gui_params = array(),
array  $mail_params = array(),
array  $context_params = array() 
)
static
Parameters
mixed$gui
string$cmd
array$gui_params
array$mail_params
array$context_params
Returns
string

Definition at line 60 of file class.ilMailFormCall.php.

61 {
62 return self::getTargetUrl('&', $gui, $cmd, $gui_params, $mail_params, $context_params);
63 }

References $cmd.

Referenced by ilObjUserFolderGUI\mailObject(), ilObjRoleGUI\mailToRoleObject(), ilMailMemberSearchGUI\nextMailForm(), ilExerciseManagementGUI\redirectFeedbackMailObject(), ilBookmarkAdministrationGUI\sendmail(), ilLPTableBaseGUI\sendMail(), ilObjContentObjectGUI\sendMailToBlockedUsers(), ilMailMemberSearchGUI\sendMailToSelectedUsers(), ilMembershipGUI\sendMailToSelectedUsers(), ilObjCourseGUI\sendMailToSelectedUsersObject(), and ilObjGroupGUI\sendMailToSelectedUsersObject().

+ Here is the caller graph for this function:

◆ getRefererRedirectUrl()

static ilMailFormCall::getRefererRedirectUrl ( )
static
Returns
string

Definition at line 179 of file class.ilMailFormCall.php.

180 {
181 $session = ilSession::get(self::SESSION_KEY);
182
183 $url = $session[self::REFERER_KEY];
184 if(strlen($url))
185 {
186 $parts = parse_url($url);
187 if(isset($parts['query']) && strlen($parts['query']))
188 {
189 $url .= '&returned_from_mail=1';
190 }
191 else
192 {
193 $url .= '?returned_from_mail=1';
194 }
195 }
196
197 unset($session[self::REFERER_KEY]);
198 ilSession::set(self::SESSION_KEY, $session);
199
200 return $url;
201 }
const REFERER_KEY
HTTP-GET parameter for the referer url.
static set($a_var, $a_val)
Set a value.
$url
Definition: shib_logout.php:72

References $url, ilSession\get(), REFERER_KEY, and ilSession\set().

Referenced by ilMailFormGUI\cancelMail(), ilMailFormGUI\saveDraft(), and ilMailFormGUI\sendMessage().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getSignature()

static ilMailFormCall::getSignature ( )
static

Get preset signature.

Returns
string signature

Definition at line 163 of file class.ilMailFormCall.php.

164 {
165 $session = ilSession::get(self::SESSION_KEY);
166
167 $sig = $session[self::SIGNATURE_KEY];
168
169 unset($session[self::SIGNATURE_KEY]);
170 ilSession::set(self::SESSION_KEY, $session);
171
172 return $sig;
173 }
const SIGNATURE_KEY
Session parameter for the hash.

References ilSession\get(), ilSession\set(), and SIGNATURE_KEY.

+ Here is the call graph for this function:

◆ isRefererStored()

static ilMailFormCall::isRefererStored ( )
static
Returns
bool

Definition at line 207 of file class.ilMailFormCall.php.

208 {
209 $session = ilSession::get(self::SESSION_KEY);
210 return isset($session[self::REFERER_KEY]) && strlen($session[self::REFERER_KEY]) ? true : false;
211 }

References ilSession\get().

Referenced by ilMailFormGUI\cancelMail(), ilMailFormGUI\saveDraft(), and ilMailFormGUI\sendMessage().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ setContextId()

static ilMailFormCall::setContextId (   $id)
static
Parameters
$idstring

Definition at line 229 of file class.ilMailFormCall.php.

230 {
231 $session = ilSession::get(self::SESSION_KEY);
232 $session[self::CONTEXT_KEY] = $id;
233 ilSession::set(self::SESSION_KEY, $session);
234 }
const CONTEXT_KEY
Session parameter for the context.

References CONTEXT_KEY, ilSession\get(), and ilSession\set().

+ Here is the call graph for this function:

◆ setContextParameters()

static ilMailFormCall::setContextParameters ( array  $parameters)
static
Parameters
array$parameters
Returns
array

Definition at line 253 of file class.ilMailFormCall.php.

254 {
255 $session = ilSession::get(self::SESSION_KEY);
256 $session[self::CONTEXT_PREFIX] = $parameters;
257 ilSession::set(self::SESSION_KEY, $session);
258 }

References CONTEXT_PREFIX, ilSession\get(), and ilSession\set().

+ Here is the call graph for this function:

◆ setRecipients()

static ilMailFormCall::setRecipients ( array  $recipients)
static
Parameters
array$recipients

Definition at line 263 of file class.ilMailFormCall.php.

264 {
265 $session = ilSession::get(self::SESSION_KEY);
266 $session['rcp_to'] = $recipients;
267 ilSession::set(self::SESSION_KEY, $session);
268 }

References ilSession\get(), and ilSession\set().

Referenced by ilMailGUI\executeCommand(), ilMailMemberSearchGUI\sendMailToSelectedUsers(), ilObjCourseGUI\sendMailToSelectedUsersObject(), and ilObjGroupGUI\sendMailToSelectedUsersObject().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ storeReferer()

static ilMailFormCall::storeReferer (   $request_params)
static
Parameters
array$request_params

Definition at line 123 of file class.ilMailFormCall.php.

124 {
125 $session = ilSession::get(self::SESSION_KEY);
126 if(isset($request_params[self::REFERER_KEY]))
127 {
128 $session[self::REFERER_KEY] = base64_decode(rawurldecode($request_params[self::REFERER_KEY]));
129 $session[self::SIGNATURE_KEY] = base64_decode(rawurldecode($request_params[self::SIGNATURE_KEY]));
130
131 $ctx_params = array();
132 foreach($request_params as $key => $value)
133 {
134 $prefix = substr($key, 0, strlen(self::CONTEXT_PREFIX));
135 if($prefix == self::CONTEXT_PREFIX)
136 {
137 if($key == self::CONTEXT_KEY)
138 {
139 $ctx_params[$key] = $value;
140 }
141 else
142 {
143 $ctx_params[substr($key, strlen(self::CONTEXT_PREFIX . '_'))] = $value;
144 }
145 }
146 }
147 $session[self::CONTEXT_PREFIX] = $ctx_params;
148 }
149 else
150 {
151 unset($session[self::REFERER_KEY]);
152 unset($session[self::SIGNATURE_KEY]);
153 unset($session[self::CONTEXT_PREFIX]);
154 }
155 ilSession::set(self::SESSION_KEY, $session);
156 }

References CONTEXT_PREFIX, ilSession\get(), REFERER_KEY, ilSession\set(), and SIGNATURE_KEY.

Referenced by ilMailGUI\executeCommand().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Field Documentation

◆ CONTEXT_KEY

const ilMailFormCall::CONTEXT_KEY = 'ctx_template'

◆ CONTEXT_PREFIX

const ilMailFormCall::CONTEXT_PREFIX = 'ctx'

Session parameter for the context.

Definition at line 30 of file class.ilMailFormCall.php.

Referenced by getContextParameters(), setContextParameters(), and storeReferer().

◆ REFERER_KEY

const ilMailFormCall::REFERER_KEY = 'r'

HTTP-GET parameter for the referer url.

Definition at line 20 of file class.ilMailFormCall.php.

Referenced by getRefererRedirectUrl(), and storeReferer().

◆ SESSION_KEY

const ilMailFormCall::SESSION_KEY = 'mail_transport'

Definition at line 15 of file class.ilMailFormCall.php.

◆ SIGNATURE_KEY

const ilMailFormCall::SIGNATURE_KEY = 'sig'

Session parameter for the hash.

Definition at line 25 of file class.ilMailFormCall.php.

Referenced by getSignature(), ilExerciseManagementGUI\redirectFeedbackMailObject(), and storeReferer().


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