Skip to content
This repository has been archived by the owner on Dec 27, 2023. It is now read-only.

Link Operation Modes

Sean McGregor edited this page Aug 2, 2013 · 3 revisions

Status: Deprecated:
This specification is being removed from the browser extensions.

Links are injected if they contain privlyInject1 somewhere in the href and the server is on the whitelist. Otherwise, the link is not injected. The host page can also prevent a link from being injected by turning off injection on an anchor with data-privly-exclude=true as an attribute, or globally by setting the same attribute on the body tag.

Prior versions allowed for links to give messages that are displayed, but don't require a full Injectable Application. This functionality increased cognitive load for the users, so it is being removed.

Future versions will support more robust directives on injectable regions.

Deprecated

Definitions:

  • Active mode link injection: A link is automatically injected when the extension replaces the link with the referenced content without the user needing to click it. These "injected links" form a web application.
  • Passive mode link injection: A link is passively injected when a user clicks on the Privly-type link. These passive mode links can present messages to users.

Links encountered by the extensions are processed according to the whitelist status of the link and the mode of operation of the extension. Links are in active mode when the extension is in active mode, and the domain is on the whitelist. In all other cases, the link will be in passive mode.

Passive Mode Rules

Links in passive mode can be modified to present messages to the user. The messages are stored on the URL's query string or anchor text (see: URL Specification). The relevant URL parameters are:

  • privlyPassiveMessage: This message is displayed if the content is not burnt. To avoid Phishing, the message must be prefixed by "Privly Content:"
  • privlyBurntMessage: This message is displayed if the content is burnt. To avoid Phishing, the message must be prefixed by "Privly Burnt Message:"

If neither of the messages are specified (or the content is not burnt and the passive message is unspecified), the message will be "Injectable Privly Content".