You are here

Home » API reference » No Referrer 7

README.txt in No Referrer 7

Same filename and directory in other branches
  1. 8 README.txt
NO REFERRER
===========

The rel="noreferrer" link type[1] indicates that no referrer information is to
be leaked when following the link. It enhances privacy by allowing users to
avoid leaking referrer information when they click on (or prefetch) links to
external sites. It also enhances security by preventing the linked page from
gaining access to the linking page via the window.opener object.

This module adds a rel="noreferrer" link type to all external links generated by
code (e.g. menu module). It also adds the rel="noopener" link type to links with
a target. You can toggle both link types on and off if, for example, you want
only the security protections of rel="noopener" without the privacy protections
of rel="noreferrer".

This module also provides a filter which, if enabled for a text format, adds the
rel="noopener" and rel="noreferrer" link types to links in user-generated
content. You will probably want to enable the 'Add rel="noopener" and/or
rel="noreferrer" to links' filter on all of your text formats.

Whitelisted domains can be defined, to which referrer URLs will be sent. If
desired, you may also publish your list of whitelisted domains as a JSON file,
to which other sites can subscribe. Alternately, you may subscribe to another
site's list of whitelisted domains.

If metatag module[2] is installed, you may also want to enable the meta referrer
element[3] to set a referrer policy[4] for the page.

[1] https://html.spec.whatwg.org/multipage/semantics.html#link-type-noreferrer
[2] https://www.drupal.org/project/metatag
[3] https://www.w3.org/TR/referrer-policy/#referrer-policy-delivery-meta
[4] https://www.w3.org/TR/referrer-policy/#referrer-policies

File

README.txt
View source 
  1. NO REFERRER

  2. ===========

  3. 

  4. The rel="noreferrer" link type[1] indicates that no referrer information is to

  5. be leaked when following the link. It enhances privacy by allowing users to

  6. avoid leaking referrer information when they click on (or prefetch) links to

  7. external sites. It also enhances security by preventing the linked page from

  8. gaining access to the linking page via the window.opener object.

  9. 

  10. This module adds a rel="noreferrer" link type to all external links generated by

  11. code (e.g. menu module). It also adds the rel="noopener" link type to links with

  12. a target. You can toggle both link types on and off if, for example, you want

  13. only the security protections of rel="noopener" without the privacy protections

  14. of rel="noreferrer".

  15. 

  16. This module also provides a filter which, if enabled for a text format, adds the

  17. rel="noopener" and rel="noreferrer" link types to links in user-generated

  18. content. You will probably want to enable the 'Add rel="noopener" and/or

  19. rel="noreferrer" to links' filter on all of your text formats.

  20. 

  21. Whitelisted domains can be defined, to which referrer URLs will be sent. If

  22. desired, you may also publish your list of whitelisted domains as a JSON file,

  23. to which other sites can subscribe. Alternately, you may subscribe to another

  24. site's list of whitelisted domains.

  25. 

  26. If metatag module[2] is installed, you may also want to enable the meta referrer

  27. element[3] to set a referrer policy[4] for the page.

  28. 

  29. [1] https://html.spec.whatwg.org/multipage/semantics.html#link-type-noreferrer

  30. [2] https://www.drupal.org/project/metatag

  31. [3] https://www.w3.org/TR/referrer-policy/#referrer-policy-delivery-meta

  32. [4] https://www.w3.org/TR/referrer-policy/#referrer-policies