+
+ Processes a given URL for use in the src attribute of an
+ audio, img or video element. The function
+ distigushes between this cases:
+
+
+ - The URL starts with
http:// or https://
+ -
+ In this case the URL is threated as an absolute URL pointing to a resource
+ outside of CCM. If any parameters are passed to the function they are appended
+ to the URL.
+
+ - The URL starts with a slash (
/)
+ -
+ In this case the URL points to a resource managed by the CCM which also
+ manages the theme. In this case the URL is prefixed with the
+
dispatcher-prefix and the parameters, if any, are appended.
+
+ - Other cases
+ -
+ If none of the two other cases match the URL points to a URL in the theme. In
+ this case the URL is processed by the
+
+
gen-path
+ function. The parameters, if any
+ are appended.
+
+
+
+ If parameters are passed to this function they are appended to the URL. The
+ parameters are passed as string formatted as URL parameters, for example
+ foo=hello&bar=world. A leading ? or &
+ is removed before adding the string the URL. If the URL already contains parameters
+ (if the URL contains a ?) the paramters string is added with a leading
+ ampersand (&). If not the parameters are appended using a
+ ? character.
+
+
+