1 | <?php |
||
2 | define( 'YOURLS_ADMIN', true ); |
||
3 | require_once( dirname( __DIR__ ).'/includes/load-yourls.php' ); |
||
4 | yourls_maybe_require_auth(); |
||
5 | |||
6 | yourls_html_head( 'tools', yourls__( 'Cool YOURLS Tools' ) ); |
||
7 | yourls_html_logo(); |
||
8 | yourls_html_menu(); |
||
9 | ?> |
||
10 | |||
11 | <main role="main" class="sub_wrap"> |
||
12 | |||
13 | <h2><?php yourls_e( 'Bookmarklets' ); ?></h2> |
||
14 | |||
15 | <p><?php yourls_e( 'YOURLS comes with handy <span>bookmarklets</span> for easier link shortening and sharing.' ); ?></p> |
||
16 | |||
17 | <h3><?php yourls_e( 'Standard or Instant, Simple or Custom' ); ?></h3> |
||
18 | |||
19 | <ul> |
||
20 | <li><?php yourls_e( 'The <span>Standard Bookmarklets</span> will take you to a page where you can easily edit or delete your brand new short URL.' ); ?></li> |
||
0 ignored issues
–
show
|
|||
21 | |||
22 | <li><?php yourls_e( 'The <span>Instant Bookmarklets</span> will pop the short URL without leaving the page you are viewing (depending on the page and server configuration, they may silently fail)' ); ?></li> |
||
23 | |||
24 | <li><?php yourls_e( 'The <span>Simple Bookmarklets</span> will generate a short URL with a random or sequential keyword.' ); ?></li> |
||
0 ignored issues
–
show
|
|||
25 | |||
26 | <li><?php yourls_e( 'The <span>Custom Keyword Bookmarklets</span> will prompt you for a custom keyword first.' ); ?></li> |
||
0 ignored issues
–
show
|
|||
27 | </ul> |
||
28 | |||
29 | <p><?php |
||
0 ignored issues
–
show
|
|||
30 | yourls_e( "If you want to share a description along with the link you're shortening, simply <span>select text</span> on the page you're viewing before clicking on your bookmarklet link" ); |
||
0 ignored issues
–
show
|
|||
31 | ?></p> |
||
32 | |||
33 | <p><?php yourls_e( '<strong>Important Note:</strong> bookmarklets <span>may fail</span> on websites with <em>https</em>, especially the "Instant" bookrmarklets. There is nothing you can do about this.'); ?></p> |
||
34 | |||
35 | <h3><?php yourls_e( 'The Bookmarklets' ); ?></h3> |
||
36 | |||
37 | <?php $base_bookmarklet = yourls_admin_url( 'index.php' ); ?> |
||
38 | |||
39 | <p><?php yourls_e( 'Click and drag links to your toolbar (or right-click and bookmark it)' ); ?></p> |
||
0 ignored issues
–
show
|
|||
40 | |||
41 | <table class="tblSorter" cellpadding="0" cellspacing="1"> |
||
42 | <thead> |
||
43 | <tr> |
||
44 | <td> </td> |
||
45 | <th><?php yourls_e( 'Standard (new page)' ); ?></th> |
||
46 | <th><?php yourls_e( 'Instant (popup)' ); ?></th> |
||
47 | </tr> |
||
48 | </thead> |
||
49 | <tbody> |
||
50 | <tr> |
||
51 | <th class="header"><?php yourls_e( 'Simple' ); ?></th> |
||
52 | |||
53 | <td> |
||
54 | <?php $js_code = <<<STANDARD_SIMPLE |
||
55 | // Simple Standard Bookmarklet (new page, no keyword asked) |
||
56 | var d = document, |
||
57 | w = window, |
||
58 | enc = encodeURIComponent, |
||
59 | e = w.getSelection, |
||
60 | k = d.getSelection, |
||
61 | x = d.selection, |
||
62 | s = (e ? e() : (k) ? k() : (x ? x.createRange().text : 0)), |
||
63 | s2 = ((s.toString() == '') ? s : enc(s)), |
||
64 | f = '$base_bookmarklet', |
||
65 | l = d.location.href, |
||
66 | ups = l.match( /^[a-zA-Z0-9\+\.-]+:(\/\/)?/ )[0], |
||
67 | ur = l.split(new RegExp(ups))[1], |
||
68 | ups = ups.split(/\:/), |
||
69 | p = '?up='+enc(ups[0]+':')+'&us='+enc(ups[1])+'&ur='+enc(ur)+'&t='+enc(d.title)+'&s='+s2, |
||
70 | u = f + p; |
||
71 | try { |
||
72 | throw ('ozhismygod'); |
||
73 | } catch (z) { |
||
74 | a = function () { |
||
75 | if (!w.open(u)) l.href = u; |
||
76 | }; |
||
77 | if (/Firefox/.test(navigator.userAgent)) setTimeout(a, 0); |
||
78 | else a(); |
||
79 | } |
||
80 | void(0); |
||
81 | STANDARD_SIMPLE; |
||
82 | yourls_bookmarklet_link( yourls_make_bookmarklet( $js_code ), yourls__( 'Shorten' ) ); |
||
83 | ?> |
||
84 | </td> |
||
85 | |||
86 | <td> |
||
87 | <?php $js_code = <<<POPUP_SIMPLE |
||
88 | // Simple Popup (in-page popup dialog, no keyword asked) |
||
89 | var d = document, |
||
90 | sc = d.createElement('script'), |
||
91 | l = d.location.href, |
||
92 | enc = encodeURIComponent, |
||
93 | ups = l.match( /^[a-zA-Z0-9\+\.-]+:(\/\/)?/ )[0], |
||
94 | ur = l.split(new RegExp(ups))[1], |
||
95 | ups = ups.split(/\:/), |
||
96 | p = '?up='+enc(ups[0]+':')+'&us='+enc(ups[1])+'&ur='+enc(ur)+'&t='+enc(d.title); |
||
97 | window.yourls_callback = function (r) { |
||
98 | if (r.short_url) { |
||
99 | prompt(r.message, r.short_url); |
||
100 | } else { |
||
101 | alert('An error occured: ' + r.message); |
||
102 | } |
||
103 | }; |
||
104 | sc.src = '$base_bookmarklet' + p + '&jsonp=yourls'; |
||
105 | void(d.body.appendChild(sc)); |
||
106 | POPUP_SIMPLE; |
||
107 | yourls_bookmarklet_link( yourls_make_bookmarklet( $js_code ), yourls__( 'Instant Shorten' ) ); |
||
108 | ?> |
||
109 | </td> |
||
110 | |||
111 | </tr> |
||
112 | <tr> |
||
113 | <th class="header"><?php yourls_e( 'Custom Keyword' ); ?></th> |
||
114 | |||
115 | <td> |
||
116 | <?php $js_code = <<<CUSTOM_STANDARD |
||
117 | // Custom Standard (new page, prompt for a keyword) |
||
118 | var d = document, |
||
119 | enc = encodeURIComponent, |
||
120 | w = window, |
||
121 | e = w.getSelection, |
||
122 | k = d.getSelection, |
||
123 | x = d.selection, |
||
124 | s = (e ? e() : (k) ? k() : (x ? x.createRange().text : 0)), |
||
125 | s2 = ((s.toString() == '') ? s : enc(s)), |
||
126 | f = '$base_bookmarklet', |
||
127 | l = d.location.href, |
||
128 | ups = l.match( /^[a-zA-Z0-9\+\.-]+:(\/\/)?/ )[0], |
||
129 | ur = l.split(new RegExp(ups))[1], |
||
130 | ups = ups.split(/\:/), |
||
131 | k = prompt("Custom URL"), |
||
132 | k2 = (k ? '&k=' + k : ""), |
||
133 | p = '?up='+enc(ups[0]+':')+'&us='+enc(ups[1])+'&ur='+enc(ur)+'&t='+enc(d.title)+'&s='+s2 + k2, |
||
134 | u = f + p; |
||
135 | if (k != null) { |
||
136 | try { |
||
137 | throw ('ozhismygod'); |
||
138 | } catch (z) { |
||
139 | a = function () { |
||
140 | if (!w.open(u)) l = u; |
||
141 | }; |
||
142 | if (/Firefox/.test(navigator.userAgent)) setTimeout(a, 0); |
||
143 | else a(); |
||
144 | } |
||
145 | void(0) |
||
146 | } |
||
147 | CUSTOM_STANDARD; |
||
148 | yourls_bookmarklet_link( yourls_make_bookmarklet( $js_code ), yourls__( 'Custom shorten' ) ); |
||
149 | ?> |
||
150 | </td> |
||
151 | |||
152 | <td> |
||
153 | <?php $js_code = <<<CUSTOM_POPUP |
||
154 | // Custom Popup (prompt for a keyword + on-page popup) |
||
155 | var d = document, |
||
156 | l = d.location.href, |
||
157 | k = prompt('Custom URL'), |
||
158 | enc = encodeURIComponent, |
||
159 | ups = l.match( /^[a-zA-Z0-9\+\.-]+:(\/\/)?/ )[0], |
||
160 | ur = l.split(new RegExp(ups))[1], |
||
161 | ups = ups.split(/\:/), |
||
162 | p = '?up='+enc(ups[0]+':')+'&us='+enc(ups[1])+'&ur='+enc(ur)+'&t='+enc(d.title); |
||
163 | sc = d.createElement('script'); |
||
164 | if (k != null) { |
||
165 | window.yourls_callback = function (r) { |
||
166 | if (r.short_url) { |
||
167 | prompt(r.message, r.short_url); |
||
168 | } else { |
||
169 | alert('An error occured: ' + r.message); |
||
170 | } |
||
171 | }; |
||
172 | sc.src = '$base_bookmarklet' + p + '&k=' + k + '&jsonp=yourls'; |
||
173 | void(d.body.appendChild(sc)); |
||
174 | } |
||
175 | CUSTOM_POPUP; |
||
176 | yourls_bookmarklet_link( yourls_make_bookmarklet( $js_code ), yourls__( 'Instant Custom Shorten' ) ); |
||
177 | ?> |
||
178 | </td> |
||
179 | |||
180 | </tr> |
||
181 | </tbody> |
||
182 | </table> |
||
183 | |||
184 | |||
185 | <h3><?php yourls_e( 'Social Bookmarklets' ); ?></h3> |
||
186 | |||
187 | <p><?php yourls_e( 'Create a short URL and share it on social networks, all in one click!' ); ?> |
||
188 | <?php yourls_e( 'Click and drag links to your toolbar (or right-click and bookmark it)' ); ?></p> |
||
189 | |||
190 | <p><?php yourls_e( 'Shorten and share:' ); ?></p> |
||
191 | |||
192 | <p> |
||
193 | <?php $js_code = <<<FACEBOOK |
||
194 | // Share on Facebook |
||
195 | var d = document, |
||
196 | enc = encodeURIComponent, |
||
197 | f = '$base_bookmarklet', |
||
198 | l = d.location.href, |
||
199 | ups = l.match( /^[a-zA-Z0-9\+\.-]+:(\/\/)?/ )[0], |
||
200 | ur = l.split(new RegExp(ups))[1], |
||
201 | ups = ups.split(/\:/), |
||
202 | p = '?up=' + enc(ups[0]+':') + '&us=' + enc(ups[1]) + '&ur=' + enc(ur) + '&t=' + enc(d.title) + '&share=facebook', |
||
203 | u = f + p; |
||
204 | try { |
||
205 | throw ('ozhismygod'); |
||
206 | } catch (z) { |
||
207 | a = function () { |
||
208 | if (!window.open(u,'Share','width=500,height=340,left=100','_blank')) l.href = u; |
||
209 | }; |
||
210 | if (/Firefox/.test(navigator.userAgent)) setTimeout(a, 0); |
||
211 | else a(); |
||
212 | } |
||
213 | void(0); |
||
214 | FACEBOOK; |
||
215 | yourls_bookmarklet_link( yourls_make_bookmarklet( $js_code ), yourls__( 'YOURLS & Facebook' ) ); |
||
216 | ?> |
||
217 | |||
218 | <?php $js_code = <<<TWITTER |
||
219 | // Share on Twitter |
||
220 | var d = document, |
||
221 | w = window, |
||
222 | enc = encodeURIComponent, |
||
223 | e = w.getSelection, |
||
224 | k = d.getSelection, |
||
225 | x = d.selection, |
||
226 | s = (e ? e() : (k) ? k() : (x ? x.createRange().text : 0)), |
||
227 | s2 = ((s.toString() == '') ? s : '%20%22' + enc(s) + '%22'), |
||
228 | f = '$base_bookmarklet', |
||
229 | l = d.location.href, |
||
230 | ups = l.match( /^[a-zA-Z0-9\+\.-]+:(\/\/)?/ )[0], |
||
231 | ur = l.split(new RegExp(ups))[1], |
||
232 | ups = ups.split(/\:/), |
||
233 | p = '?up=' + enc(ups[0]+':') + '&us=' + enc(ups[1]) + '&ur='+enc(ur) + '&t=' + enc(d.title) + s2 + '&share=twitter', |
||
234 | u = f + p; |
||
235 | try { |
||
236 | throw ('ozhismygod'); |
||
237 | } catch (z) { |
||
238 | a = function () { |
||
239 | if (!w.open(u,'Share','width=780,height=265,left=100','_blank')) l = u; |
||
240 | }; |
||
241 | if (/Firefox/.test(navigator.userAgent)) setTimeout(a, 0); |
||
242 | else a(); |
||
243 | } |
||
244 | void(0); |
||
245 | TWITTER; |
||
246 | yourls_bookmarklet_link( yourls_make_bookmarklet( $js_code ), yourls__( 'YOURLS & Twitter' ) ); |
||
247 | ?> |
||
248 | |||
249 | <?php $js_code = <<<TUMBLR |
||
250 | // Share on Tumlr |
||
251 | var d = document, |
||
252 | w = window, |
||
253 | enc = encodeURIComponent, |
||
254 | share = 'tumblr', |
||
255 | e = w.getSelection, |
||
256 | k = d.getSelection, |
||
257 | x = d.selection, |
||
258 | s = (e ? e() : (k) ? k() : (x ? x.createRange().text : 0)), |
||
259 | s2 = ((s.toString() == '') ? s : '%20%22' + enc(s) + '%22'), |
||
260 | f = '$base_bookmarklet', |
||
261 | l = d.location.href, |
||
262 | ups = l.match( /^[a-zA-Z0-9\+\.-]+:(\/\/)?/ )[0], |
||
263 | ur = l.split(new RegExp(ups))[1], |
||
264 | ups = ups.split(/\:/), |
||
265 | p = '?up=' + enc(ups[0]+':') + '&us=' + enc(ups[1]) + '&ur='+enc(ur) + '&t=' + enc(d.title) + '&s=' + s2 + '&share=tumblr', |
||
266 | u = f + p; |
||
267 | try { |
||
268 | throw ('ozhismygod'); |
||
269 | } catch (z) { |
||
270 | a = function () { |
||
271 | if (!w.open(u,'Share','width=450,height=450,left=430','_blank')) l = u; |
||
272 | }; |
||
273 | if (/Firefox/.test(navigator.userAgent)) setTimeout(a, 0); |
||
274 | else a(); |
||
275 | } |
||
276 | void(0); |
||
277 | TUMBLR; |
||
278 | yourls_bookmarklet_link( yourls_make_bookmarklet( $js_code ), yourls__( 'YOURLS & Tumblr' ) ); |
||
279 | ?> |
||
280 | |||
281 | <?php yourls_do_action( 'social_bookmarklet_buttons_after' ); ?> |
||
282 | |||
283 | </p> |
||
284 | |||
285 | <h2><?php yourls_e( 'Prefix-n-Shorten' ); ?></h2> |
||
286 | |||
287 | <p><?php yourls_se( "When viewing a page, you can also prefix its full URL: just head to your browser's address bar, add \"<span>%s</span>\" to the beginning of the current URL (right before its 'http://' part) and hit enter.", preg_replace('@https?://@', '', yourls_get_yourls_site()) . '/' ); ?></p> |
||
288 | |||
289 | <p><?php |
||
0 ignored issues
–
show
|
|||
290 | yourls_e( 'Note: this will probably not work if your web server is running on Windows' ); |
||
291 | if( yourls_is_windows() ) |
||
292 | yourls_e( ' (which seems to be the case here)' ); |
||
293 | ?>.</p> |
||
294 | |||
295 | |||
296 | <?php if( yourls_is_private() ) { ?> |
||
297 | |||
298 | <h2><?php yourls_e( 'Secure passwordless API call' ); ?></h2> |
||
299 | |||
300 | <p><?php |
||
0 ignored issues
–
show
|
|||
301 | yourls_e( 'YOURLS allows API calls the old fashioned way, using <tt>username</tt> and <tt>password</tt> parameters.' ); |
||
0 ignored issues
–
show
|
|||
302 | echo "\n"; |
||
303 | yourls_e( "If you're worried about sending your credentials into the wild, you can also make API calls without using your login or your password, using a secret signature token." ); |
||
0 ignored issues
–
show
|
|||
304 | ?></p> |
||
305 | |||
306 | <p><?php yourls_se( 'Your secret signature token: <strong><code>%s</code></strong>', yourls_auth_signature() ); ?> |
||
307 | <?php yourls_e( "(It's a secret. Keep it secret) "); ?></p> |
||
308 | |||
309 | <p><?php yourls_e( 'This signature token can only be used with the API, not with the admin interface.' ); ?></p> |
||
0 ignored issues
–
show
|
|||
310 | |||
311 | <ul> |
||
312 | <li><h3><?php yourls_e( 'Usage of the signature token' ); ?></h3> |
||
313 | <p><?php yourls_e( 'Simply use parameter <tt>signature</tt> in your API requests. Example:' ); ?></p> |
||
0 ignored issues
–
show
|
|||
314 | <p><code><?php echo yourls_get_yourls_site(); ?>/yourls-api.php?signature=<?php echo yourls_auth_signature(); ?>&action=...</code></p> |
||
315 | </li> |
||
316 | |||
317 | <li><h3><?php yourls_e( 'Usage of a time limited signature token' ); ?></h3> |
||
318 | <pre><code><?php |
||
319 | $timestamp = time(); |
||
320 | <tt>// <?php yourls_e( 'actual value:' ); ?> $time = <?php $time = time(); echo $time; ?></tt> |
||
0 ignored issues
–
show
|
|||
321 | $signature = md5( $timestamp . '<?php echo yourls_auth_signature(); ?>' ); |
||
322 | <tt>// <?php yourls_e( 'actual value:' ); ?> $signature = "<?php $sign = md5( $time. yourls_auth_signature() ); echo $sign; ?>"</tt> |
||
0 ignored issues
–
show
|
|||
323 | ?> |
||
324 | </code></pre> |
||
325 | <p><?php yourls_e( 'Now use parameters <tt>signature</tt> and <tt>timestamp</tt> in your API requests. Example:' ); ?></p> |
||
0 ignored issues
–
show
|
|||
326 | <p><code><?php echo yourls_get_yourls_site(); ?>/yourls-api.php?timestamp=<strong>$timestamp</strong>&signature=<strong>$signature</strong>&action=...</code></p> |
||
327 | <p><?php yourls_e( 'Actual values:' ); ?><br/> |
||
328 | <tt><?php echo yourls_get_yourls_site(); ?>/yourls-api.php?timestamp=<?php echo $time; ?>&signature=<?php echo $sign; ?>&action=...</tt></p> |
||
329 | <p><?php yourls_se( 'This URL would be valid for only %s seconds', YOURLS_NONCE_LIFE ); ?></p> |
||
330 | </li> |
||
331 | </ul> |
||
332 | |||
333 | <p><?php yourls_se( 'See the <a href="%s">Passwordless API</a> page on the wiki.', 'https://yourls.org/passwordlessapi' ); ?> |
||
334 | <?php yourls_se( 'See the <a href="%s">API documentation</a> for more', yourls_get_yourls_site() . '/readme.html#API' ); ?></p> |
||
335 | |||
336 | </main> |
||
337 | |||
338 | <?php } // end is private ?> |
||
339 | |||
340 | <?php yourls_html_footer(); ?> |
||
341 |
Overly long lines are hard to read on any screen. Most code styles therefor impose a maximum limit on the number of characters in a line.