Day 13: Testing & Setting Up

Setup WP-Unit Tests:

1. Install PHPUnit:
   • Ensure you have Composer installed.
   • Install PHPUnit via Composer:
   • composer require --dev phpunit/phpunit.
2. Install WP-CLI:
   • Follow the WP-CLI tutorial.
3. Install WP-Mock:
   • Use WP-CLI to install WP-Mock: wp plugin install wp-mock --activate.
4. Configure PHPUnit:
   • Create a phpunit.xml file in the root of your project.
   • Adjust WP_TESTS_DIR to point to your WordPress test suite directory.
   • Example configuration:

<phpunit bootstrap="tests/bootstrap.php">
  <testsuites>
    <testsuite name="WordPress Plugin Test Suite">
      <file>tests/test-sample.php</file>
    </testsuite>
  </testsuites>
  <php>
    <env name="WP_TESTS_DIR" value="/path/to/wordpress-tests"/>
  </php>
</phpunit>

Write Sample Unit Tests:

Create Test File:

Create a directory named tests in your plugin/theme root.

Create a file named test-sample.php inside the tests directory.

Create a Test Class:

Example class in

<?php
class MyTest extends WP_UnitTestCase {
  public function test_sample() {
    // Assert that true is true
    $this->assertTrue(true);
  }
}

Run Tests:

Execute tests using PHPUnit: vendor/bin/phpunit or just phpunit if you have global composer.

Theme Testing:

1. Setup Testing Environment:
   • Use a local development environment like Local by Flywheel or XAMPP.
   • Install WordPress and your theme.
2. Test Theme Functionality:
   • Functional Testing: Verify that all theme features work as intended, including widgets, menus, and custom post types.
   • Cross-Browser Testing: Check theme appearance and functionality across different browsers and devices.
   • Responsive Design Testing: Ensure the theme is mobile-friendly and adapts to different screen sizes.
3. Automated Testing:
   • Create unit tests using PHPUnit for theme functions.
   • Use tools like Theme Unit Test Data for content testing.
   • Test custom template files and theme-specific functions with WP_UnitTestCase.

Plugin Testing:

1. Setup Testing Environment:
   • Similar to theme testing, use a local environment to install WordPress and your plugin.
2. Test Plugin Functionality:
   • Installation and Activation: Ensure the plugin installs and activates without errors.
   • Feature Testing: Verify that all plugin features work as expected, including settings, shortcodes, and admin pages.
   • Conflict Testing: Check for conflicts with other plugins and themes.
3. Automated Testing:
   • Create unit and integration tests using PHPUnit.
   • Mock WordPress functions and API calls using WP-Mock for more controlled tests.
   • Write test cases for specific plugin functionalities, ensuring edge cases are covered.

Best Practices:

• Regularly update tests as you develop new features.
• Use Continuous Integration (CI) tools to automate testing.
• Document test cases and maintain a testing checklist for thorough coverage.
• Define what each test is verifying and ensure it covers both common and edge cases.

Thank you for reading…
By ~Leaveitblank(Mayank Tripathi)