d2be0295992066b6ff61cfabb77bfc56b399c7f4
[plewww.git] / plekit / php / linetabs.php
1 <?php
2   // $Id$
3
4 require_once 'plekit-utils.php';
5 require_once 'prototype.php';
6
7 drupal_set_html_head('
8 <script type="text/javascript" src="/plekit/linetabs/linetabs.js"></script>
9 <link href="/plekit/linetabs/linetabs.css" rel="stylesheet" type="text/css" />
10 ');
11
12
13 // the expected argument is an (ordered) associative array
14 // ( label => todo , ...)
15 // label is expected to be the string to display in the menu
16 // todo can be either
17 // (*) a string : it is then taken to be a URL to move to
18 // (*) or an associative array with the following keys
19 //     (*) 'label' : if set, this overrides the string key just above
20 //         this is used for functions that return a tab, more convenient to write&use
21 //     (*) 'method': 'POST' or 'GET' -- default is 'GET'
22 //     (*) 'url': where to go
23 //     (*) 'values': an associative array of (key,value) pairs to send to the URL; values are strings
24 //     (*) 'confirm': a question to display before actually triggering
25 //     (*) 'bubble': a longer message displayed when the mouse stays quite for a while on the label
26 //     (*) 'image' : the url of an image used instead of the label
27 //     (*) 'height' : used for the image
28 //     (*) 'id' : assign given id to the <li> element
29
30 // NOTE
31 // (*) values can also be set in the URL, e.g. ?var=value&foo=bar, even for POST'ing
32 // (*) several instances can appear on the same page but you need to give them different id's
33
34 // EXAMPLES
35 // function my_tab () { return array('label'=>'Go to google','url'=>'http://google.com'); }
36 // $tabs=array();
37 // $tabs[] = my_tab();
38 // $tabs['Simple Tab']="http://planet-lab.org";
39 // $tabs['Complex Tab']=array('url'=>'http://planet-lab.org/',
40 //                            'bubble'=>'This text gets displayed when the mouse remains over for a while');
41 // plekit_linetabs($tabs);
42
43 ////////// Notes: limited support for images
44 // (*) for some reason, confirmation does not work with image tabs 
45 //     (the form gets submitted whatever the confirmation....)
46 // (*) you need to tune the image size, which is wrong, as the image should rather be bottom-aligned 
47
48 function plekit_linetabs ($tabs, $id=NULL) {
49   // do not output anything if $tabs has no entry (unpleasant rendering)
50   if (empty ($tabs)) return;
51   $active_line_tab=$_GET['active_line_tab'];
52   // need id to pass to the onclick function attached to the input buttons
53   $id="linetabs";
54   if (! $id) $id .= '-' + $id;
55   print "<div id='$id' class='linetabs'>";
56   print "<ul>";
57   foreach ($tabs as $label=>$todo) {
58     // in case we have a simple string, rewrite it as an array
59     if (is_string ($todo)) $todo=array('method'=>'GET','url'=>$todo);
60     // the 'label' key, if set in the hash, supersedes key
61     if ($todo['label']) $label=$todo['label'];
62     $tracer="";
63     if ($todo['id']) $tracer .= "id=".$todo['id'];
64     print "<li $tracer>";
65     // set default method
66     if ( ! $todo['method'] ) $todo['method']='GET';
67     // extract var=value settings from url if any
68     $full_url=$todo['url'];
69     $split=plekit_split_url($full_url);
70     $url=$split['url'];
71     $url_values=$split['values'];
72
73     // create form
74     $method=strtolower($todo['method']);
75     print "<form action='$url' method='$method'><fieldset>";
76     // set values
77     $values=$todo['values'];
78     if ( ! $values) $values = array();
79     if ($url_values) $values = array_merge($values,$url_values);
80     if ( $values ) foreach ($values as $key=>$value) {
81       if ($key != "active_line_tab")
82         print "<input type='hidden' name='$key' value='$value' />";
83     }
84     print "<input type='hidden' name='active_line_tab' value='$label' />";
85     if ($label == $active_line_tab) $tracer = "class='linetabs-submit active'";
86     else $tracer="class='linetabs-submit'";
87     // image and its companions 'height' 
88     if ($todo['image']) {
89       $what=$todo['image'];
90       $type="type='image' src='$what'";
91       if ($todo['height']) {
92         $what=$todo['height'];
93         $type .= " height='$what'";
94       }
95     } else {
96       $type="type='button' value='$label'";
97     }
98     $bubble=htmlspecialchars($todo['bubble'], ENT_QUOTES);
99     print "<span title='$bubble'>";
100     $message="";
101     if ($todo['confirm']) $message=htmlspecialchars($todo['confirm'], ENT_QUOTES) . " ?";
102     print "<input $tracer $type onclick='linetabs_namespace.submit(\"$id\",\"$message\")' />";
103     print "</span>";
104     print "</fieldset></form></li>\n";
105   }
106   print '</ul>';
107   print '</div>';
108   print "<p class='linetabs'></p>\n";
109 }
110
111 ?>