This project is not covered by Drupal’s security advisory policy.
The Render As module adds the ability for elements to be rendered as a specific user and/or role(s), which can be used for the purposes of testing how content will be seen by another user or a user or a particular role without having to change users.
How to use
The Render As API module is intended for developers, and can be used in two
different ways:
-
#renderas parameter.
Any element being passed through the render() or drupal_render() function that has a registered #type (markup, page, value, etc) will trigger the Render As behaviour if the #renderas parameter is present and keyed appropriated (see below).
If the element is not a registered #type or has not #type you can still use the Render As beahviour by attaching the Render As #pre_render and #post_render callbacks along with the #renderas parameter:
$element['#pre_render'][] = 'renderas_api_element_pre_render'; $element['#post_render'][] = 'renderas_api_element_post_render';
-
renderas()/drupal_renderas() function.
Render As also comes with some wrapper functions for the standard render() and drupal_render() functions, being renderas() and drupal_renderas(). These functions take an additional argument, an array which contains the Render As parameter settings to be bound to the supplied element, keyed as below.
Render As parameter format:
The Render As parameter expects an array with one or both of the following keys:
- uid: The user ID of the user to be used to render the element.
- roles: A keyed array of roles to be used to render the element, where the key is the role ID.
Example:
The following will render the supplied element with user 0 (anonymous user) with the 'authenticated user' role applied to it.
array(
'uid' => 0,
'roles' => array(
2 => 'authenticated user',
),
);
Project information
- Seeking co-maintainer(s)
Maintainers are looking for help reviewing issues. - Module categories: Developer Tools
- Created by Deciphered on , updated
- This project is not covered by the security advisory policy.
Use at your own risk! It may have publicly disclosed vulnerabilities.