Nuevo plugin Additionals 2.0.20

plugins/additionals/docs/macros/iframe.rst

@@ -0,0 +1,42 @@
+Iframe
+------
+
+Iframe macro for Redmine.
+
+.. function:: {{iframe(url [, width=INT, height=INT, with_link=BOOL])}}
+
+    Include an Iframe into Redmine. If your Redmine is running with HTTPS, only iframes with
+    HTTPS are accepted by this macro.
+
+    :param string url: URL to website
+    :param int width: width (default is 100%)
+    :param int height: height (default is 485)
+    :param bool with_link: true or false (if link to url should be displayed below iframe)
+
+    Note 1: you can only include an iframe, if the website of the iframe url does allow it. If not, you
+    will get a empty page with the HTTP header info:
+
+    ``Load denied by X-Frame-Options: https://your-target-url.com/ does not permit cross-origin framing.``
+
+    Note 2: Your Redmine webserver can also block your iframe inclusion, check your `Content Security Policy (CSP) <https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP>`_
+
+Scope
++++++
+
+This macro works in all text fields with formatting support.
+
+Examples
+++++++++
+
+
+Show iframe of URL ``https://www.google.com/``
+
+.. code-block:: smarty
+
+  {{iframe(https://www.google.com/)}}
+
+Show iframe of URL https://www.google.com/ and show link to it
+
+.. code-block:: smarty
+
+  {{iframe(https://www.google.com/, with_link: true)}}