YOURLS / YOURLS

user/plugins/sample-plugin/plugin.php

<?php
/*

Empty line required before block comment

Plugin Name: Sample Plugin

First line of comment not aligned correctly; expected 4 spaces but found 0

Plugin URI: http://yourls.org/

Comment line indented incorrectly; expected at least 4 spaces but found 0

Description: Sample plugin to illustrate how actions and filters work. Read its source. Refer to the <a href="http://yourls.org/pluginapi">Plugin API documentation</a> for more details.

This line exceeds maximum limit of 100 characters; contains 185 characters

Comment line indented incorrectly; expected at least 4 spaces but found 0

Version: 0.1

Comment line indented incorrectly; expected at least 4 spaces but found 0

Author: Ozh

Comment line indented incorrectly; expected at least 4 spaces but found 0

Author URI: http://ozh.org/

Comment line indented incorrectly; expected at least 4 spaces but found 0

*/

// No direct call
if( !defined( 'YOURLS_ABSPATH' ) ) die();

/* Example of an action

Block comment text must start on a new line

 *
 * We're going to add an entry to the menu.
 *
 * The menu is drawn by function yourls_html_menu() in file includes/functions-html.php.
 * Right before the function outputs the closing </ul>, notice the following function call:
 * yourls_do_action( 'admin_menu' );
 * This function says: "hey, for your information, I've just done something called 'admin menu', thought I'd let you know..."

This line exceeds maximum limit of 100 characters; contains 125 characters

 *
 * We're going to hook into this action and add our menu entry
 */
 
yourls_add_action( 'admin_menu', 'ozh_sample_add_menu' );
/* This says: when YOURLS does action 'admin_menu', call function 'ozh_sample_add_menu'

Block comment text must start on a new line

 */

function ozh_sample_add_menu() {
	echo '<li><a href="http://ozh.org/">Ozh</a></li>';
}
/* And that's it. Activate the plugin and notice the new menu entry.

Block comment text must start on a new line

 */

 

/* Example of a filter

Block comment text must start on a new line

 *
 * We're going to modify the <title> of pages in the admin area
 *
 * The <title> tag is generated by function yourls_html_head() in includes/functions-html.php
 * Notice the following function call:
 * $title = yourls_apply_filter( 'html_title', 'YOURLS: Your Own URL Shortener' );
 * This function means: give $title the value "YOURLS: Your Own URL Shortener", unless a
 * filter modifies this value.
 *
 * We're going to hook into this filter and modify this value.
 */
 
yourls_add_filter( 'html_title', 'ozh_sample_change_title' );
/* This says: when filter 'html_title' is triggered, send its value to function 'ozh_sample_change_title'

This line exceeds maximum limit of 100 characters; contains 105 characters

Block comment text must start on a new line

 * and use what this function will return.
 */
 
function ozh_sample_change_title( $value ) {
	$value = $value . ' -- the sample plugin is activated';
	return $value; // a filter *always* has to return a value
}
/* And that's it. Activate the plugin and notice how the page title changes */

Single line block comment not allowed; use inline ("// text") comment instead