Drupal includes jQuery and jQuery UI.
+ $build['content'] = array( + '#markup' => <<We have two examples of using these:
Config Node Type Example is a basic example of defining a content type through configuration YAML files.
diff --git a/node_type_example/lib/Drupal/node_type_example/Tests/NodeTypeExampleTest.php b/node_type_example/lib/Drupal/node_type_example/Tests/NodeTypeExampleTest.php index f44f194..af2ccbf 100644 --- a/node_type_example/lib/Drupal/node_type_example/Tests/NodeTypeExampleTest.php +++ b/node_type_example/lib/Drupal/node_type_example/Tests/NodeTypeExampleTest.php @@ -45,10 +45,10 @@ class NodeTypeExampleTest extends WebTestBase { * - That we can create content using the user interface. * - That our created content does appear in the database. */ - function testNodeTypes() { + public function testNodeTypes() { // Log in an admin user. - $adminUser = $this->drupalCreateUser(array('administer content types')); - $this->drupalLogin($adminUser); + $admin_user = $this->drupalCreateUser(array('administer content types')); + $this->drupalLogin($admin_user); // Get a list of content types. $this->drupalGet('admin/structure/types'); @@ -58,14 +58,14 @@ class NodeTypeExampleTest extends WebTestBase { // Check for the locked status of our content types. // $nodeType will be of type Drupal\node\NodeTypeInterface - $nodeType = node_type_load('basic_content_type'); - $this->assertFalse($nodeType->isLocked(), 'basic_content_type is not locked.'); - $nodeType = node_type_load('locked_content_type'); - $this->assertEqual('locked_content_type', $nodeType->isLocked(), 'locked_content_type is locked.'); + $node_type = node_type_load('basic_content_type'); + $this->assertFalse($node_type->isLocked(), 'basic_content_type is not locked.'); + $node_type = node_type_load('locked_content_type'); + $this->assertEqual('locked_content_type', $node_type->isLocked(), 'locked_content_type is locked.'); // Log in a content creator. - $creatorUser = $this->drupalCreateUser(array('create basic_content_type content')); - $this->drupalLogin($creatorUser); + $creator_user = $this->drupalCreateUser(array('create basic_content_type content')); + $this->drupalLogin($creator_user); // Create a node. $edit = array(); diff --git a/node_type_example/node_type_example.module b/node_type_example/node_type_example.module index ad6b9ed..4d0b5fa 100644 --- a/node_type_example/node_type_example.module +++ b/node_type_example/node_type_example.module @@ -4,6 +4,7 @@ * @file * node_type_example module file. */ + /** * @defgroup node_type_example Example: Config Node Type * @ingroup examples diff --git a/page_example/lib/Drupal/page_example/Controller/PageExampleController.php b/page_example/lib/Drupal/page_example/Controller/PageExampleController.php index 32a200b..5ba21eb 100644 --- a/page_example/lib/Drupal/page_example/Controller/PageExampleController.php +++ b/page_example/lib/Drupal/page_example/Controller/PageExampleController.php @@ -19,9 +19,14 @@ class PageExampleController { * * Our router maps this method to the path 'examples/page_example'. */ - function description() { + public function description() { $build = array( - '#markup' => t('The Page example module provides two pages, "simple" and "arguments".
The simple page just returns a renderable array for display.
The arguments page takes two arguments and displays them, as in @arguments_link
', array('@simple_link' => url('examples/page_example/simple', array('absolute' => TRUE)), '@arguments_link' => url('examples/page_example/arguments/23/56', array('absolute' => TRUE)))) + '#markup' => t('The Page example module provides two pages, "simple" and "arguments".
The simple page just returns a renderable array for display.
The arguments page takes two arguments and displays them, as in @arguments_link
', + array( + '@simple_link' => url('examples/page_example/simple', array('absolute' => TRUE)), + '@arguments_link' => url('examples/page_example/arguments/23/56', array('absolute' => TRUE)), + ), + ), ); return $build; @@ -37,9 +42,9 @@ class PageExampleController { * page. The theme system will later render and surround the content with the * appropriate blocks, navigation, and styling. */ - function simple() { + public function simple() { return array( - '#markup' => '' . t('Simple page: The quick brown fox jumps over the lazy dog.') . '
' + '#markup' => '' . t('Simple page: The quick brown fox jumps over the lazy dog.') . '
', ); } @@ -70,7 +75,7 @@ class PageExampleController { * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException * If the parameters are invalid. */ - function arguments($first, $second) { + public function arguments($first, $second) { // Make sure you don't trust the URL to be safe! Always check for exploits. if (!is_numeric($first) || !is_numeric($second)) { // We will just show a standard "access denied" page in this case. diff --git a/page_example/lib/Drupal/page_example/Tests/PageExampleTest.php b/page_example/lib/Drupal/page_example/Tests/PageExampleTest.php index e4fcf32..5686f55 100644 --- a/page_example/lib/Drupal/page_example/Tests/PageExampleTest.php +++ b/page_example/lib/Drupal/page_example/Tests/PageExampleTest.php @@ -31,13 +31,13 @@ class PageExampleTest extends WebTestBase { /** * Generates a random string of ASCII numeric characters (values 48 to 57). * - * @param $length + * @param int $length * Length of random string to generate. * - * @return + * @return string * Randomly generated string. */ - private static function randomNumber($length = 8) { + protected static function randomNumber($length = 8) { $str = ''; for ($i = 0; $i < $length; $i++) { $str .= chr(mt_rand(48, 57)); @@ -48,11 +48,11 @@ class PageExampleTest extends WebTestBase { /** * Verify that current user has no access to page. * - * @param $url + * @param string $url * URL to verify. */ function pageExampleVerifyNoAccess($url) { - // Test that page returns 403 Access Denied + // Test that page returns 403 Access Denied. $this->drupalGet($url); $this->assertResponse(403); } @@ -63,9 +63,9 @@ class PageExampleTest extends WebTestBase { * Login user, create an example node, and test page functionality through * the admin and user interfaces. */ - function testPageExampleBasic() { + public function testPageExampleBasic() { // Verify that anonymous user can't access the pages created by - // page_example module + // page_example module. $this->pageExampleVerifyNoAccess('examples/page_example/simple'); $this->pageExampleVerifyNoAccess('examples/page_example/arguments/1/2'); @@ -116,7 +116,7 @@ class PageExampleTest extends WebTestBase { $this->drupalGet('examples/page_example/arguments/non-numeric-argument/' . $second); $this->assertResponse(403, 'User got 403 for string argument in first position.'); - // Check if user can't access simple page + // Check if user can't access simple page. $this->pageExampleVerifyNoAccess('examples/page_example/simple'); } diff --git a/page_example/page_example.module b/page_example/page_example.module index 8151f17..15ed0a1 100644 --- a/page_example/page_example.module +++ b/page_example/page_example.module @@ -97,7 +97,6 @@ function page_example_menu() { // Notice there is not a declaration entry for // 'examples/page_example/arguments/{first}/{second}' because that is only a // routing item, and not a menu item (which needs to appear on menu). - return $items; } diff --git a/phpunit_example/lib/Drupal/phpunit_example/DisplayManager.php b/phpunit_example/lib/Drupal/phpunit_example/DisplayManager.php index ef51e91..5b186e1 100644 --- a/phpunit_example/lib/Drupal/phpunit_example/DisplayManager.php +++ b/phpunit_example/lib/Drupal/phpunit_example/DisplayManager.php @@ -26,18 +26,45 @@ class DisplayManager { protected $items; + /** + * Add a displayable item. + * + * @param DisplayInfoInterface $item + * The item to add. + */ public function addDisplayableItem(DisplayInfoInterface $item) { $this->items[$item->getDisplayName()] = $item; } + /** + * A count of how many items exist. + * + * @return int + * The number of items that exist. + */ public function countDisplayableItems() { return count($this->items); } + /** + * All displayable items. + * + * @return array + * The displayable items. + */ public function displayableItems() { return $this->items; } + /** + * Find an item by its name. + * + * @param string $name + * The name to find. + * + * @return DisplayInfoInterface|null + * The found item, or NULL if none is found. + */ public function item($name) { if (isset($this->items[$name])) { return $this->items[$name]; diff --git a/phpunit_example/lib/Drupal/phpunit_example/Tests/PHPUnitExampleSimpleTest.php b/phpunit_example/lib/Drupal/phpunit_example/Tests/PHPUnitExampleSimpleTest.php index 48044a8..6c5fc29 100644 --- a/phpunit_example/lib/Drupal/phpunit_example/Tests/PHPUnitExampleSimpleTest.php +++ b/phpunit_example/lib/Drupal/phpunit_example/Tests/PHPUnitExampleSimpleTest.php @@ -21,6 +21,9 @@ class PHPUnitExampleSimpleTest extends WebTestBase { public static $modules = array('phpunit_example'); + /** + * {@inheritdoc} + */ public static function getInfo() { return array( 'name' => 'PHPUnit Example Tests', diff --git a/phpunit_example/phpunit_example.module b/phpunit_example/phpunit_example.module index dfbbfb9..0c01000 100644 --- a/phpunit_example/phpunit_example.module +++ b/phpunit_example/phpunit_example.module @@ -15,9 +15,6 @@ * Implements hook_help(). * * @see hook_help() - * - * @return string - * Translated string for the help text. */ function phpunit_example_help($path, $arg) { switch ($path) { @@ -35,9 +32,6 @@ function phpunit_example_help($path, $arg) { * * @see hook_menu() * @see menu_example - * - * @return array - * Complex array describing our menu item. */ function phpunit_example_menu() { $items['examples/phpunit_example'] = array(