Returns HTML code for displaying the captcha image, audio button, and form text input.
*
* Options can be specified to modify the output of the HTML. Accepted options:
*
* 'securimage_path':
* Optional: The URI to where securimage is installed (e.g. /securimage)
* 'image_id':
* A string that sets the "id" attribute of the captcha image (default: captcha_image)
* 'image_alt_text':
* The alt text of the captcha image (default: CAPTCHA Image)
* 'show_audio_button':
* true/false Whether or not to show the audio button (default: true)
* 'show_refresh_button':
* true/false Whether or not to show a button to refresh the image (default: true)
* 'show_text_input':
* true/false Whether or not to show the text input for the captcha (default: true)
* 'refresh_alt_text':
* Alt text for the refresh image (default: Refresh Image)
* 'refresh_title_text':
* Title text for the refresh image link (default: Refresh Image)
* 'input_id':
* A string that sets the "id" attribute of the captcha text input (default: captcha_code)
* 'input_name':
* A string that sets the "name" attribute of the captcha text input (default: same as input_id)
* 'input_text':
* A string that sets the text of the label for the captcha text input (default: Type the text:)
* 'input_attributes':
* An array of additional HTML tag attributes to pass to the text input tag (default: empty)
* 'image_attributes':
* An array of additional HTML tag attributes to pass to the captcha image tag (default: empty)
* 'error_html':
* Optional HTML markup to be shown above the text input field
* 'namespace':
* The optional captcha namespace to use for showing the image and playing back the audio. Namespaces are for using multiple captchas on the same page.
*
* @param array $options Array of options for modifying the HTML code.
*
* @return string The generated HTML code for displaying the captcha