├── README.md
└── ios-url-schemes
    └── plugin.php


/README.md:
--------------------------------------------------------------------------------
 1 | iOS URL Schemes Plugin
 2 | =============================
 3 | 
 4 | Simple plugin for <a href="http://yourls.org">YOURLS</a> URL shortener. Plugin adds support for redirects to URLs starting with itms-apps:// and itms-services://
 5 | 
 6 | This plugin requires YOURLS 1.6 (http://yourls.org) or higher
 7 | 
 8 | Download
 9 | --------
10 | The plugin does all you need to redirect to itms-apps and itms-services URLs. You can add own protocols by adding your custom items to the <code>$protocols</code> array.
11 | 
12 | 1. Download the plugin using the <b>Download</b> button(s) above.
13 | 2. Copy to your YOURLS installation root into `users/plugins`.
14 | 3. Activate the plugin in 'Manage Plugins' <code>YOURLS_ROOT/admin/plugins.php</code>
15 | 
16 | Install
17 | -------
18 | 
19 | Copy the <code>ios-url-schemes</code> folder into <code>user/plugins</code>
20 | Go to the Plugins administration page inside YOURLS Admin and activate the plugin.
21 | 


--------------------------------------------------------------------------------
/ios-url-schemes/plugin.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /*
 3 | Plugin Name: iOS URL Schemes
 4 | Plugin URI: https://github.com/suculent/yourls-ios-url-schemes-plugin
 5 | Description: Support for itms-services URL scheme for linking to iOS Enterprise App Installation Manifest
 6 | Version: 1.3.1
 7 | Author: Suculent
 8 | Author URI: http://www.github.com/suculent/
 9 | */
10 | 
11 | // No direct call
12 | if( !defined( 'YOURLS_ABSPATH' ) ) die();
13 | 
14 | /* Filter hook
15 |  * 
16 |  * This plugin hooks as a is_allowed_protocol filter. 
17 |  */
18 | 
19 | yourls_add_filter( 'is_allowed_protocol', 'suculent_itms_protocols' );
20 | 
21 | /* Filter implementation
22 |  * 
23 |  * This applies for both iOS protocols, apps for iTunes listing and services for installation. When the
24 |  * $url contains (e.g. starts with) supported protocol string. Returns true for supported protocols.
25 |  */
26 | 
27 | function suculent_itms_protocols( $args, $url ) {
28 | 	/* List of protocols added by this plugin */
29 | 	$protocols = array( 'itms-services://', 'itms-apps://', 'http://', 'https://');
30 | 	
31 | 	/* Walk through the list and check if URL starts with one of known protocols. */
32 | 	foreach ( $protocols as $protocol ) {	
33 | 		if ( suculent_starts_with( $url, $protocol ) === TRUE ) return true;
34 | 	}
35 | 	
36 | 	/* None of protocols supported by this plugin has been found in the URL */
37 | 	return false;
38 | } 
39 | 
40 | /* Convenience function
41 |  * 
42 |  * Returns true if $haystack starts with $needle. Funny name comes from naming conventions.
43 |  */
44 | 
45 | function suculent_starts_with( $haystack, $needle )
46 | {
47 |     return !strncmp( $haystack, $needle, strlen( $needle ) );
48 | }
49 | ?>
50 | 


--------------------------------------------------------------------------------