silverstripe-iframe/README.md

36 lines
1.7 KiB
Markdown
Raw Normal View History

2013-02-27 05:09:14 +01:00
# IFrame module
2021-01-21 04:36:05 +01:00
2022-07-05 08:56:57 +02:00
[![CI](https://github.com/silverstripe/silverstripe-iframe/actions/workflows/ci.yml/badge.svg)](https://github.com/silverstripe/silverstripe-iframe/actions/workflows/ci.yml)
2022-08-01 00:08:57 +02:00
[![Silverstripe supported module](https://img.shields.io/badge/silverstripe-supported-0071C4.svg)](https://www.silverstripe.org/software/addons/silverstripe-commercially-supported-module-list/)
2013-02-27 05:09:14 +01:00
## Introduction
The IFrame module provides an IFrame page type in the CMS which allows you to embed an IFrame into a page without
resorting to custom code in your templates or TinyMCE instance.
This can help if you have `iframe` disabled in TinyMCE's [valid_elements](https://www.tiny.cloud/docs-3x/reference/configuration/Configuration3x@valid_elements/)
and do not want to to re-enable it in for a single/specific use-case. It's also possible that using a Web Application
Firewall (WAF) may block page save requests that contain iframe elements in HTML content, which using this module would
circumvent.
Various attributes of the IFrame can be controlled from CMS fields, such as size and content that surrounds the
IFrame itself.
2013-02-27 05:09:14 +01:00
## Installation
2023-04-19 06:18:52 +02:00
```sh
composer require silverstripe/iframe
```
2013-02-27 05:09:14 +01:00
## Instructions
For usage instructions see the [user manual](docs/en/userguide/index.md).
2013-10-24 22:21:58 +02:00
## Contributing
### Translations
Translations of the natural language strings are managed through a third party translation interface, transifex.com. Newly added strings will be periodically uploaded there for translation, and any new translations will be merged back to the project source code.
Please use [https://www.transifex.com/projects/p/silverstripe-iframe](https://www.transifex.com/projects/p/silverstripe-iframe) to contribute translations, rather than sending pull requests with YAML files.