1.0

.ci-env.sh

@@ -0,0 +1 @@
+export PHPCS_IGNORE=minify/*

admin.css

@@ -14,3 +14,16 @@
 .fixed .column-expires {
 	width: 12%;
 }
+
+.nav-tab-content {
+	display: none;
+}
+.form-table th small {
+	display: block;
+	clear: both;
+	color: #999;
+}
+.form-table td label {
+	display: block;
+	clear:both;
+}

admin.js

@@ -0,0 +1,23 @@
+jQuery( function( $ ) {
+
+	// Admin page tabs
+	var $tabs       = $( '.nav-tab-wrapper' ),
+	    $panels     = $( '.nav-tab-content' ),
+	    currentHash = window.location.hash;
+
+	$tabs.on( 'click', 'a', function() {
+		var hash = $( this ).attr( 'href' ).replace( '#tab-', '#tab-content-' ); // prevents page scrolling if hash is present
+
+		$panels.hide().filter( hash ).show();
+
+		$tabs.find( 'a' ).removeClass( 'nav-tab-active' ).filter( $( this ) ).addClass( 'nav-tab-active' );
+	});
+
+	$tabs.find( currentHash ? 'a[href="' + currentHash + '"]' : ':first' ).trigger( 'click' );
+
+	// Fix input-inside-label glitch
+	$panels.on( 'click', 'input[type=text]', function( e ) {
+		e.preventDefault();
+	});
+
+});

bin/.coveralls.yml

@@ -0,0 +1,4 @@
+service_name: travis-ci
+src_dir: .
+coverage_clover: build/logs/clover.xml
+json_path: build/logs/coveralls-upload.json

bin/.travis.yml

@@ -10,24 +10,36 @@ node_js:
     - 0.10
 
 env:
-    - WP_VERSION=master WP_MULTISITE=0
-    - WP_VERSION=master WP_MULTISITE=1
     - WP_VERSION=latest WP_MULTISITE=0
     - WP_VERSION=latest WP_MULTISITE=1
+    - WP_VERSION=3.8 WP_MULTISITE=0
+    - WP_VERSION=3.8 WP_MULTISITE=1
 
 before_script:
     - export WP_TESTS_DIR=/tmp/wordpress-tests/
     - export PLUGIN_DIR=$(pwd)
     - export PLUGIN_SLUG=$(basename $(pwd) | sed 's/^wp-//')
-    - if [ -e phpunit.xml ] || [ -e phpunit.xml.dist ]; then bash bin/install-wp-tests.sh wordpress_test root '' localhost $WP_VERSION; cd /tmp/wordpress/wp-content/plugins; ln -s $PLUGIN_DIR $PLUGIN_SLUG; cd $PLUGIN_DIR; fi
-    - pear config-set auto_discover 1
-    - pear install PHP_CodeSniffer
-    - git clone git://github.com/WordPress-Coding-Standards/WordPress-Coding-Standards.git $(pear config-get php_dir)/PHP/CodeSniffer/Standards/WordPress
-    - phpenv rehash
+    - export PHPCS_DIR=/tmp/phpcs
+    - export PHPCS_GITHUB_SRC=squizlabs/PHP_CodeSniffer
+    - export PHPCS_GIT_TREE=master
+    - export PHPCS_IGNORE='tests/*,vendor/*'
+    - export WPCS_DIR=/tmp/wpcs
+    - export WPCS_GITHUB_SRC=WordPress-Coding-Standards/WordPress-Coding-Standards
+    - export WPCS_GIT_TREE=master
+    - export WPCS_STANDARD=$(if [ -e phpcs.ruleset.xml ]; then echo phpcs.ruleset.xml; else echo WordPress-Core; fi)
+    - if [ -e .ci-env.sh ]; then source .ci-env.sh; fi
+    - if [ -e phpunit.xml ] || [ -e phpunit.xml.dist ]; then wget -O /tmp/install-wp-tests.sh https://raw.githubusercontent.com/wp-cli/wp-cli/master/templates/install-wp-tests.sh; bash /tmp/install-wp-tests.sh wordpress_test root '' localhost $WP_VERSION; cd /tmp/wordpress/wp-content/plugins; ln -s $PLUGIN_DIR $PLUGIN_SLUG; cd $PLUGIN_DIR; fi
+    - mkdir -p $PHPCS_DIR && curl -L https://github.com/$PHPCS_GITHUB_SRC/archive/$PHPCS_GIT_TREE.tar.gz | tar xvz --strip-components=1 -C $PHPCS_DIR
+    - mkdir -p $WPCS_DIR && curl -L https://github.com/$WPCS_GITHUB_SRC/archive/$WPCS_GIT_TREE.tar.gz | tar xvz --strip-components=1 -C $WPCS_DIR
+    - $PHPCS_DIR/scripts/phpcs --config-set installed_paths $WPCS_DIR
     - npm install -g jshint
+    - if [ -e composer.json ]; then wget http://getcomposer.org/composer.phar && php composer.phar install --dev; fi
 
 script:
     - find . -path ./bin -prune -o \( -name '*.php' -o -name '*.inc' \) -exec php -lf {} \;
-    - if [ -e phpunit.xml ] || [ -e phpunit.xml.dist ]; then phpunit; fi
-    - phpcs --standard=$(if [ -e ruleset.xml ]; then echo ruleset.xml; else echo WordPress; fi) $(find . -name '*.php')
+    - if [ -e phpunit.xml ] || [ -e phpunit.xml.dist ]; then phpunit $( if [ -e .coveralls.yml ]; then echo --coverage-clover build/logs/clover.xml; fi ); fi
+    - $PHPCS_DIR/scripts/phpcs --standard=$WPCS_STANDARD $(if [ -n "$PHPCS_IGNORE" ]; then echo --ignore=$PHPCS_IGNORE; fi) $(find . -name '*.php')
     - jshint .
+
+after_script:
+    - if [ -e .coveralls.yml ]; then php vendor/bin/coveralls; fi

bin/class-wordpress-readme-parser.php

@@ -42,7 +42,7 @@ function __construct( $args = array() ) {
 				throw new Exception( "Parse error in $metadatum" );
 			}
 			list( $name, $value )  = array_slice( $metadataum_matches, 1, 2 );
-			$this->metadata[$name] = $value;
+			$this->metadata[ $name ] = $value;
 		}
 		$this->metadata['Contributors'] = preg_split( '/\s*,\s*/', $this->metadata['Contributors'] );
 		$this->metadata['Tags'] = preg_split( '/\s*,\s*/', $this->metadata['Tags'] );
@@ -58,11 +58,17 @@ function __construct( $args = array() ) {
 			$body        = trim( array_shift( $section_match ) );
 			$subsections = array();
 
-			// @todo Parse out front matter /(.+?)(\n=\s+.+$)/s
+			// Check if there is front matter
+			if ( preg_match( '/^(\s*[^=].+?)(?=\n=|$)(.*$)/s', $body, $matches ) ) {
+				$body = $matches[1];
+				$subsection_search_area = $matches[2];
+			} else {
+				$subsection_search_area = $body;
+				$body = null;
+			}
 
 			// Parse subsections
-			if ( preg_match_all( '/(?:^|\n)= (.+?) =\n(.+?)(?=\n= |$)/s', $body, $subsection_matches, PREG_SET_ORDER ) ) {
-				$body = null;
+			if ( preg_match_all( '/(?:^|\n)= (.+?) =\n(.+?)(?=\n= |$)/s', $subsection_search_area, $subsection_matches, PREG_SET_ORDER ) ) {
 				foreach ( $subsection_matches as $subsection_match ) {
 					array_shift( $subsection_match );
 					$subsections[] = array(
@@ -94,12 +100,6 @@ function to_markdown( $params = array() ) {
 
 		// Parse sections
 		$section_formatters = array(
-			'Description' => function ( $body ) use ( $params ) {
-				if ( isset( $params['travis_ci_url'] ) ) {
-					$body .= sprintf( "\n\n[![Build Status](%s.png?branch=master)](%s)", $params['travis_ci_url'], $params['travis_ci_url'] );
-				}
-				return $body;
-			},
 			'Screenshots' => function ( $body ) {
 				$body = trim( $body );
 				$new_body = '';
@@ -172,6 +172,17 @@ function ( $tag ) {
 		foreach ( $formatted_metadata as $name => $value ) {
 			$markdown .= sprintf( "**%s:** %s  \n", $name, $value );
 		}
+
+		if ( isset( $params['travis_ci_url'] ) || isset( $params['coveralls_url'] ) ) {
+			$markdown .= "\n";
+			if ( isset( $params['travis_ci_url'] ) ) {
+				$markdown .= sprintf( '[![Build Status](%s.png?branch=master)](%s) ', $params['travis_ci_url'], $params['travis_ci_url'] );
+			}
+			if ( isset( $params['coveralls_url'] ) ) {
+				$markdown .= sprintf( '[![Build Status](%s?branch=master)](%s) ', $params['coveralls_badge_src'], $params['coveralls_url'] );
+			}
+			$markdown .= "\n";
+		}
 		$markdown .= "\n";
 
 		foreach ( $this->sections as $section ) {
@@ -181,8 +192,8 @@ function ( $tag ) {
 			$body = $section['body'];
 
 			$body = call_user_func( $general_section_formatter, $body );
-			if ( isset( $section_formatters[$section['heading']] ) ) {
-				$body = trim( call_user_func( $section_formatters[$section['heading']], $body ) );
+			if ( isset( $section_formatters[ $section['heading'] ] ) ) {
+				$body = trim( call_user_func( $section_formatters[ $section['heading'] ], $body ) );
 			}
 
 			if ( $body ) {

bin/generate-markdown-readme

@@ -39,8 +39,14 @@ try {
 	$readme = new WordPress_Readme_Parser( array( 'path' => $readme_txt_path ) );
 
 	$md_args = array();
+	$github_url_regex = '#.+github\.com[:/]([^/]+/[^/]+)\.git$#';
+	$origin_url = trim( `git config --get remote.origin.url` );
 	if ( file_exists( $readme_root . '/.travis.yml' ) ) {
-		$md_args['travis_ci_url'] = preg_replace( '/^.+?:(.+)\.git$/', 'https://travis-ci.org/$1', trim( `git config --get remote.origin.url` ) );
+		$md_args['travis_ci_url'] = preg_replace( $github_url_regex, 'https://travis-ci.org/$1', $origin_url );
+	}
+	if ( file_exists( $readme_root . '/.coveralls.yml' ) ) {
+		$md_args['coveralls_badge_src'] = preg_replace( $github_url_regex, 'https://coveralls.io/repos/$1/badge.png', $origin_url );
+		$md_args['coveralls_url'] = preg_replace( $github_url_regex, 'https://coveralls.io/r/$1', $origin_url );
 	}
 	$markdown = $readme->to_markdown( $md_args );
 

bin/phpcs.ruleset.xml

@@ -2,26 +2,8 @@
 <ruleset name="WordPress Coding Standards for Plugins">
 	<description>Generally-applicable sniffs for WordPress plugins</description>
 
-	<rule ref="WordPress">
-		<exclude name="WordPress.VIP.RestrictedFunctions"/>
-		<exclude name="WordPress.VIP.SuperGlobalInputUsage"/>
-		<exclude name="WordPress.VIP.ValidatedSanitizedInput"/>
-	</rule>
-	<rule ref="WordPress.NamingConventions.ValidFunctionName">
-		<exclude-pattern>/tests/*</exclude-pattern><!-- because of PHPUnit method names -->
-	</rule>
+	<rule ref="WordPress-Extra" />
 
-	<rule ref="Squiz.WhiteSpace.SuperfluousWhitespace"/>
-	<rule ref="Generic.PHP.DisallowShortOpenTag"/>
-	<rule ref="Generic.Files.ByteOrderMark"/>
-	<rule ref="Generic.PHP.LowerCaseConstant"/>
-	<rule ref="Generic.WhiteSpace.DisallowSpaceIndent"/>
-	<rule ref="Generic.PHP.NoSilencedErrors" />
-	<rule ref="Generic.ControlStructures.InlineControlStructure" />
-	<rule ref="Generic.Files.LineEndings">
-		<properties>
-			<property name="eolChar" value="\n"/>
-		</properties>
-	</rule>
+	<exclude-pattern>/tests/*,/vendor/*</exclude-pattern>
 
 </ruleset>

bin/pre-commit

@@ -3,6 +3,11 @@
 
 set -e
 
+WPCS_STANDARD=$(if [ -e phpcs.ruleset.xml ]; then echo phpcs.ruleset.xml; else echo WordPress-Core; fi)
+if [ -e .ci-env.sh ]; then
+	source .ci-env.sh
+fi
+
 message="Checking staged changes..."
 git_status_egrep='^[MARC].+'
 
@@ -44,9 +49,30 @@ if [ ${#staged_php_files[@]} != 0 ]; then
 	# PHPUnit
 	if [ -e phpunit.xml ] || [ -e phpunit.xml.dist ]; then
 		echo "## phpunit"
-		if [ "$USER" != 'vagrant' ] && command -v vagrant >/dev/null 2>&1 && command -v vassh >/dev/null 2>&1; then
-			echo "Running phpunit in vagrant..."
-			vassh phpunit
+		if [ "$USER" != 'vagrant' ]; then
+
+			# Check if we're in VVV
+			plugin_dir=$(pwd)
+			while [ ! -e Vagrantfile ]; do
+				if [ $(pwd) == '/' ] || [ "$last_dir" == $(pwd) ]; then
+					break
+				fi
+				last_dir=$(pwd)
+				cd ..
+			done
+			if [ -e Vagrantfile ] && grep -q vvv Vagrantfile; then
+				vvv_root=$(pwd)
+				absolute_vvv_plugin_path=/srv${plugin_dir:${#vvv_root}}
+			fi
+			cd $plugin_dir
+
+			if [ ! -z "$absolute_vvv_plugin_path" ]; then
+				echo "Running phpunit in VVV"
+				vagrant ssh -c "cd $absolute_vvv_plugin_path && phpunit"
+			elif command -v vassh >/dev/null 2>&1; then
+				echo "Running phpunit in vagrant via vassh..."
+				vassh phpunit
+			fi
 		elif ! command -v phpunit >/dev/null 2>&1;then
 			echo "Skipping phpunit since not installed"
 		elif [ -z "$WP_TESTS_DIR" ]; then
@@ -59,8 +85,7 @@ if [ ${#staged_php_files[@]} != 0 ]; then
 	# PHP_CodeSniffer WordPress Coding Standards
 	echo "## phpcs"
 	if command -v phpcs >/dev/null 2>&1; then
-		phpcs_standard=$(if [ -e ruleset.xml ]; then echo ruleset.xml; else echo WordPress; fi)
-		phpcs -p -s -v --standard=$phpcs_standard "${staged_php_files[@]}"
+		phpcs -p -s -v --standard=$WPCS_STANDARD $(if [ -n "$PHPCS_IGNORE" ]; then echo --ignore=$PHPCS_IGNORE; fi) "${staged_php_files[@]}"
 	else
 		echo "Skipping phpcs since not installed"
 	fi

bin/readme.md

@@ -41,6 +41,17 @@ cd .git/hooks
 ln -s ../../bin/pre-commit .
 ```
 
+You may customize the behavior of the `.travis.yml` and `pre-commit` hook by
+specifying a `.ci-env.sh` in the root of the repo, for example:
+
+```bash
+export PHPCS_GITHUB_SRC=x-team/PHP_CodeSniffer
+export PHPCS_GIT_TREE=master
+export WPCS_GIT_TREE=develop
+export WPCS_STANDARD=WordPress-Core
+export PHPCS_IGNORE='tests/*,includes/vendor/*'
+```
+
 The library includes a WordPress README [parser](class-wordpress-readme-parser.php) and [converter](generate-markdown-readme) to Markdown,
 so you don't have to manually keep your `readme.txt` on WordPress.org in sync with the `readme.md` you have on GitHub. The
 converter will also automatically recognize the presence of projects with Travis CI and include the status image