https://github.com/danielbachhuber/unholy

Markup testing for WordPress using jQuery-style selectors
https://github.com/danielbachhuber/unholy

Last synced: 19 days ago
JSON representation

Markup testing for WordPress using jQuery-style selectors

• Host: GitHub
• URL: https://github.com/danielbachhuber/unholy
• Owner: danielbachhuber
• Created: 2015-11-02T15:59:09.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2016-04-11T18:59:20.000Z (over 8 years ago)
• Last Synced: 2024-10-09T11:38:08.389Z (30 days ago)
• Language: PHP
• Homepage:
• Size: 10.7 KB
• Stars: 9
• Watchers: 4
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Unholy

========

[![Build Status](https://travis-ci.org/danielbachhuber/unholy.png?branch=master)](https://travis-ci.org/danielbachhuber/unholy)

Markup testing for WordPress using jQuery-style selectors. Uses PHPUnit, the WordPress Unit Test Suite, [QueryPath](http://querypath.org/), and [HTML5-PHP](http://masterminds.github.io/html5-php/).

It's unholy, but it works.

## Installing

These instructions presuppose you're already using PHPUnit and the WordPress Unit Test Suite with your project. If you do, you can:

1. Require Unholy using Composer: `composer require danielbachhuber/unholy`

2. Install dependencies using Composer: `composer install`

3. Load Unholy into your test suite by appending `require dirname( dirname( __FILE__ ) ) . '/vendor/autoload.php';` to the end of your `bootstrap.php`.

## Using

The `Unholy_Testcase` class extends the `WP_UnitTestcase` class. Update your project's test classes to extend `Unholy_Testcase`.

Extending the `Unholy_Testcase` class exposes two helper methods: `get_permalink_as_dom()` and `get_feed_as_dom()`. These can be used to get a DOMDocument-esque object representing the view. Then, use the `qp()` function to navigate the object using jQuery-style selectors.

As an example, here is how you might test the Twenty Fifteen theme for the site title and description in the header:

```php

get_permalink_as_dom( '/' );

		$this->assertEquals( 'Unholy Site Title', qp( $dom, '#masthead .site-title' )->text() );

		$this->assertEquals( 'Unholy Site Description', qp( $dom, '#masthead .site-description' )->text() );

	}

}

```

And here is how you might test your RSS feed for a post:

```php

factory->user->create( array( 'display_name' => 'Unholy Author' ) );

		$this->factory->post->create( array( 'post_title' => 'Unholy Post Title', 'post_author' => $user_id ) );

		$dom = $this->get_feed_as_dom( '/feed/' );

		$this->assertEquals( 'Unholy Post Title', qp( $dom, 'channel item title' )->eq(0)->text() );

		$this->assertEquals( 'Unholy Author', qp( $dom, 'channel item dc|creator')->eq(0)->text() );

	}

}

```