build a valid query string from an array

values that are arrays will be handled properly: their correpsonding keys are expected to be of the form array[]

• return: a encoded query string
• todo: allow empty values (without an equal sign)

• array $params: a array of $key => value parameters

create a SELECT listbox to choose a customer in the ones allowed

• return: a SELECT input field, with the project ids as values and the project name properly indented to create a tree as name. The customers are top-level objects with their names as values. To distinguish between the two, an underscore is prepended to the customer.
• uses: form_select()

• mixed $customer:

  if given, the list of customers to create the tree for. defaults to User::allowed_customers_arr().

  If not given or null, all the customers accessible to the currently logged-in user will be listed. If no user is currently logged in, the whole list is returned.

• string $fieldname: the name of the SELECT tag
• mixed $values: @see form_select(). defaults to $_POST

• return: link to the first page.
• static:

ease navigation through multiple pages

this returns the next offset based on the given offset and count, and based on wether we're looking for the next or previous link

next: new offset = offset + count prev: new offset = max(offset - count, 0)

• return: if there's an overflow vs count() or 0

Create a navigation bar from the given iterator

• return:

  navigation bar for an ecdIterator that looks like this:

  Prev page | 1 | 2 | 3 | 4 | ... | 10 | Next Page >>

• static:

• return: link to the next page.
• static:

Generate a phone number

Static function. Generates a phone number in a standard format: (rrr) nnn-nnnn [eee] The function makes no verification on the arguments it is fed.

• return: link to the previous page.
• static:

create a SELECT listbox for all the projects in the given customer

• return: a SELECT input field, with the project ids as values and the project name properly indented to create a tree as name. The customers are top-level objects with their names as values. To distinguish between the two, an underscore is prepended to the customer.
• uses: form_select()
• uses: User::allowed_customers_arr()

• mixed $customer:

  if given, the list of customers to create the tree for.

  Can be a string, in which case it is taken as a single customer, and the customer itself is not printed within the list.

  If not given or null, all the customers accessible to the currently logged-in user will be listed. If no user is currently logged in, the whole list is returned.

• mixed $values: @see form_select()
• string $fieldname: the name of the SELECT tag
• bool $empty_parent: if the an empty parent tag must be created, false by default. if set to true, it will be set to the $customer. only appliable when $customer is not an array.