Projet

Général

Profil

Paste
Télécharger (7,95 ko) Statistiques
| Branche: | Révision:

root / drupal7 / modules / system / system.tokens.inc @ db2d93dd

1
<?php
2

    
3
/**
4
 * @file
5
 * Builds placeholder replacement tokens system-wide data.
6
 *
7
 * This file handles tokens for the global 'site' token type, as well as
8
 * 'date' and 'file' tokens.
9
 */
10

    
11
/**
12
 * Implements hook_token_info().
13
 */
14
function system_token_info() {
15
  $types['site'] = array(
16
    'name' => t("Site information"),
17
    'description' => t("Tokens for site-wide settings and other global information."),
18
  );
19
  $types['date'] = array(
20
    'name' => t("Dates"),
21
    'description' => t("Tokens related to times and dates."),
22
  );
23
  $types['file'] = array(
24
    'name' => t("Files"),
25
    'description' => t("Tokens related to uploaded files."),
26
    'needs-data' => 'file',
27
  );
28

    
29
  // Site-wide global tokens.
30
  $site['name'] = array(
31
    'name' => t("Name"),
32
    'description' => t("The name of the site."),
33
  );
34
  $site['slogan'] = array(
35
    'name' => t("Slogan"),
36
    'description' => t("The slogan of the site."),
37
  );
38
  $site['mail'] = array(
39
    'name' => t("Email"),
40
    'description' => t("The administrative email address for the site."),
41
  );
42
  $site['url'] = array(
43
    'name' => t("URL"),
44
    'description' => t("The URL of the site's front page."),
45
  );
46
  $site['url-brief'] = array(
47
    'name' => t("URL (brief)"),
48
    'description' => t("The URL of the site's front page without the protocol."),
49
  );
50
  $site['login-url'] = array(
51
    'name' => t("Login page"),
52
    'description' => t("The URL of the site's login page."),
53
  );
54

    
55
  // Date related tokens.
56
  $date['short'] = array(
57
    'name' => t("Short format"),
58
    'description' => t("A date in 'short' format. (%date)", array('%date' => format_date(REQUEST_TIME, 'short'))),
59
  );
60
  $date['medium'] = array(
61
    'name' => t("Medium format"),
62
    'description' => t("A date in 'medium' format. (%date)", array('%date' => format_date(REQUEST_TIME, 'medium'))),
63
  );
64
  $date['long'] = array(
65
    'name' => t("Long format"),
66
    'description' => t("A date in 'long' format. (%date)", array('%date' => format_date(REQUEST_TIME, 'long'))),
67
  );
68
  $date['custom'] = array(
69
    'name' => t("Custom format"),
70
    'description' => t("A date in a custom format. See !php-date for details.", array('!php-date' => l(t('the PHP documentation'), 'http://php.net/manual/en/function.date.php'))),
71
  );
72
  $date['since'] = array(
73
    'name' => t("Time-since"),
74
    'description' => t("A date in 'time-since' format. (%date)", array('%date' => format_interval(REQUEST_TIME - 360, 2))),
75
  );
76
  $date['raw'] = array(
77
    'name' => t("Raw timestamp"),
78
    'description' => t("A date in UNIX timestamp format (%date)", array('%date' => REQUEST_TIME)),
79
  );
80

    
81

    
82
  // File related tokens.
83
  $file['fid'] = array(
84
    'name' => t("File ID"),
85
    'description' => t("The unique ID of the uploaded file."),
86
  );
87
  $file['name'] = array(
88
    'name' => t("File name"),
89
    'description' => t("The name of the file on disk."),
90
  );
91
  $file['path'] = array(
92
    'name' => t("Path"),
93
    'description' => t("The location of the file relative to Drupal root."),
94
  );
95
  $file['mime'] = array(
96
    'name' => t("MIME type"),
97
    'description' => t("The MIME type of the file."),
98
  );
99
  $file['size'] = array(
100
    'name' => t("File size"),
101
    'description' => t("The size of the file."),
102
  );
103
  $file['url'] = array(
104
    'name' => t("URL"),
105
    'description' => t("The web-accessible URL for the file."),
106
  );
107
  $file['timestamp'] = array(
108
    'name' => t("Timestamp"),
109
    'description' => t("The date the file was most recently changed."),
110
    'type' => 'date',
111
  );
112
  $file['owner'] = array(
113
    'name' => t("Owner"),
114
    'description' => t("The user who originally uploaded the file."),
115
    'type' => 'user',
116
  );
117

    
118
  return array(
119
    'types' => $types,
120
    'tokens' => array(
121
      'site' => $site,
122
      'date' => $date,
123
      'file' => $file,
124
    ),
125
  );
126
}
127

    
128
/**
129
 * Implements hook_tokens().
130
 */
131
function system_tokens($type, $tokens, array $data = array(), array $options = array()) {
132
  $url_options = array('absolute' => TRUE);
133
  if (isset($options['language'])) {
134
    $url_options['language'] = $options['language'];
135
    $language_code = $options['language']->language;
136
  }
137
  else {
138
    $language_code = NULL;
139
  }
140
  $sanitize = !empty($options['sanitize']);
141

    
142
  $replacements = array();
143

    
144
  if ($type == 'site') {
145
    foreach ($tokens as $name => $original) {
146
      switch ($name) {
147
        case 'name':
148
          $site_name = variable_get('site_name', 'Drupal');
149
          $replacements[$original] = $sanitize ? check_plain($site_name) : $site_name;
150
          break;
151

    
152
        case 'slogan':
153
          $slogan = variable_get('site_slogan', '');
154
          $replacements[$original] = $sanitize ? check_plain($slogan) : $slogan;
155
          break;
156

    
157
        case 'mail':
158
          $replacements[$original] = variable_get('site_mail', '');
159
          break;
160

    
161
        case 'url':
162
          $replacements[$original] = url('<front>', $url_options);
163
          break;
164

    
165
        case 'url-brief':
166
          $replacements[$original] = preg_replace(array('!^https?://!', '!/$!'), '', url('<front>', $url_options));
167
          break;
168

    
169
        case 'login-url':
170
          $replacements[$original] = url('user', $url_options);
171
          break;
172
      }
173
    }
174
  }
175

    
176
  elseif ($type == 'date') {
177
    if (empty($data['date'])) {
178
      $date = REQUEST_TIME;
179
    }
180
    else {
181
      $date = $data['date'];
182
    }
183

    
184
    foreach ($tokens as $name => $original) {
185
      switch ($name) {
186
        case 'short':
187
          $replacements[$original] = format_date($date, 'short', '', NULL, $language_code);
188
          break;
189

    
190
        case 'medium':
191
          $replacements[$original] = format_date($date, 'medium', '', NULL, $language_code);
192
          break;
193

    
194
        case 'long':
195
          $replacements[$original] = format_date($date, 'long', '', NULL, $language_code);
196
          break;
197

    
198
        case 'since':
199
          $replacements[$original] = format_interval((REQUEST_TIME - $date), 2, $language_code);
200
          break;
201

    
202
        case 'raw':
203
          $replacements[$original] = $sanitize ? check_plain($date) : $date;
204
          break;
205
      }
206
    }
207

    
208
    if ($created_tokens = token_find_with_prefix($tokens, 'custom')) {
209
      foreach ($created_tokens as $name => $original) {
210
        $replacements[$original] = format_date($date, 'custom', $name, NULL, $language_code);
211
      }
212
    }
213
  }
214

    
215
  elseif ($type == 'file' && !empty($data['file'])) {
216
    $file = $data['file'];
217

    
218
    foreach ($tokens as $name => $original) {
219
      switch ($name) {
220
        // Basic keys and values.
221
        case 'fid':
222
          $replacements[$original] = $file->fid;
223
          break;
224

    
225
        // Essential file data
226
        case 'name':
227
          $replacements[$original] = $sanitize ? check_plain($file->filename) : $file->filename;
228
          break;
229

    
230
        case 'path':
231
          $replacements[$original] = $sanitize ? check_plain($file->uri) : $file->uri;
232
          break;
233

    
234
        case 'mime':
235
          $replacements[$original] = $sanitize ? check_plain($file->filemime) : $file->filemime;
236
          break;
237

    
238
        case 'size':
239
          $replacements[$original] = format_size($file->filesize);
240
          break;
241

    
242
        case 'url':
243
          $replacements[$original] = $sanitize ? check_plain(file_create_url($file->uri)) : file_create_url($file->uri);
244
          break;
245

    
246
        // These tokens are default variations on the chained tokens handled below.
247
        case 'timestamp':
248
          $replacements[$original] = format_date($file->timestamp, 'medium', '', NULL, $language_code);
249
          break;
250

    
251
        case 'owner':
252
          $account = user_load($file->uid);
253
          $name = format_username($account);
254
          $replacements[$original] = $sanitize ? check_plain($name) : $name;
255
          break;
256
      }
257
    }
258

    
259
    if ($date_tokens = token_find_with_prefix($tokens, 'timestamp')) {
260
      $replacements += token_generate('date', $date_tokens, array('date' => $file->timestamp), $options);
261
    }
262

    
263
    if (($owner_tokens = token_find_with_prefix($tokens, 'owner')) && $account = user_load($file->uid)) {
264
      $replacements += token_generate('user', $owner_tokens, array('user' => $account), $options);
265
    }
266
  }
267

    
268
  return $replacements;
269
}