franck@0: <?php
franck@1: // $Id: popups.api.php,v 1.1.4.3 2010/12/10 02:09:16 drewish Exp $
franck@0: 
franck@0: /**
franck@0:  * @file
franck@0:  * Provides hook documentation for the Popups API.
franck@0:  */
franck@0: 
franck@0: /**
franck@0:  * Creates the rule registry for the popups.
franck@0:  */
franck@0: function hook_popups() {
franck@0:   $popups = array();
franck@0:   $popups['admin/content/taxonomy'] = array(
franck@1:     // Act on the first primary tab.
franck@0:     'div#tabs-wrapper a:eq(1)',
franck@0:     // Act on the 2nd column link in the table.
franck@0:     'table td:nth-child(2) a' => array(
franck@0:       // Don't update the original page.
franck@0:       'noUpdate' => TRUE,
franck@0:     ),
franck@0:   );
franck@0:   return $popups;
franck@0: }
franck@0: 
franck@0: /**
franck@0:  * Allows altering of the popup rule registry.
franck@0:  *
franck@0:  * @param $popups
franck@0:  *   The popup registry to be altered.
franck@0:  */
franck@0: function hook_popups_alter(&$popups) {
franck@0:   // Remove acting on the primary tabs.
franck@0:   unset($popups['admin/content/taxonomy']['div#tabs-wrapper a:eq(1)']);
franck@0: 
franck@0:   // Make clicking on the link update the original page.
franck@0:   $popups['admin/content/taxonomy']['table td:nth-child(2) a']['noUpdate'] = FALSE;
franck@0: }
franck@0: 
franck@0: /**
franck@0:  * Adds skins to the Popups API.
franck@0:  *
franck@0:  * Returns an associative array where the key is the skin name, along
franck@0:  * with CSS and JS values to tell where the skin can be found.
franck@0:  */
franck@0: function hook_popups_skins() {
franck@0:   $skin['My Skin'] = array(
franck@0:     'css' => drupal_get_path('module', 'myskin') .'/myskin.css',
franck@0:     'js' => drupal_get_path('module', 'myskin') .'/myskin.js',
franck@0:   );
franck@0: }