Installation

1. Extract insertFrame for drupal 5 or insertFrame for drupal 6 file in the modules directory (Or see download page)
2. Enable the module in the admin settings
3. Add the filter to an input format.

Use

To insert a frame in a node in drupal, add the following :

[[[<url> width=<w> height=<h> scrolling=<yes|no|auto> className=<class> ID=<id> offset=<offset>]]]

Don't forget to set the input format the filter has been assigned to.

Examples

1. To include the page www.myurl.com/myapp.html with auto-height with a width of 100%

     [[[www.myurl.com/myapp.html]]]

2. To include the page www.myurl.com/myapp.html with height of 500px and width of 300px

     [[[www.myurl.com/myapp.html height=500px width=300px]]]

3. To include a frame of id myframe with the myCSSClass css class

     [[[www.myurl.com/myapp.html id=myframe class=myCSSClass]]]

Features

You can add your own tags (tag=value). To custom code with this tags, you must create a theme function. To do this, add in your template.php a function called yourtheme_insertFrame_custom($onload, $iframe_params). The first param is the default code of onload event, the second, an array of all tags of the filter. You function may return any text that will be add as is in the IFRAME html tag. You can also theme the function insertFrame_init to add javascript for example.

Exemple

// Add javascript
function mytheme_insertFrame_init() {
    drupal_add_js(drupal_get_path('module', 'insertFrame') . '/myinsertFrame.js');    
}

// Add resizing feature if resize=Y
function yourtheme_insertFrame_custom($onload, $iframe_params) {
    if ($iframe_params["resize"] != "Y") {return $onload;}
    return $onload . " onresize='resize(this)'";
}

Remarks

• You can use the filter with wiki modules but you must enclose the lines with

  <nowiki>

  tag.
• if HTML filter is active, add

  <iframe>

  in the Allowed HTML tags input box in the configure tab of your input format
• Theming insertFrame_getURL($url) function, you can customize the url (with token module for example). To theme the function, see this example :

      function yourtemplage_insertFrame_getURL($url) {
        return token_replace($url);
      }