Sometimes it is just not practical to only use DotNetNuke® modules. Some legacy or custom web apps are needed for time or monetary reasons. The AutoSize IFrame is an ideal solution for web applications that are not built in DNN.
Current User In URL
Autosize IFrame can resize to the target website, or it can be used with a fixed width and height. Autosize Iframe does more than resize the Iframe, it also can use dynamic query string to pass the current Username or UserId into the target website. This helps in retrieving information about the current user.
(ie. http:\\www.mysite.com\myapp?myvar=\[userid] becomes http:\\www.mysite.com\myapp?myvar=432)
Note: The target website must exist on the same domain as the source domain for Autosizing to occur.
Note: If the target website has javascript that resizes the page, scrollbars may appear when AutoSize is enabled.
Current Date and Time in URL
Time and date formating can also be set dynamicly in the query string. It works with any standard formatting (M , MM, MMM, MMMM, dd, ect)
(ie http:\\www.mysite.com\myfolder\/[date(MMMMyyyy)]\default.html will become http:\\www.mysite.com\myfolder\August2005\default.html)
Change Target Site Dynamically
This iFrame also has the ability to change the target website by passing in an url in the query string, Create links to the page where you have Iframe and to send the user to the exact spot in your custom app they want to be.
(ie. http:\\www.mysite.com?tabid=34&AU_IFRAME=http:\\www.mysite.com\app\help.aspx)
The Iframe Url will be overriden by the query string url : http:\\www.mysite.com\app\help.aspx
Allowing custom query string url can be turned off or on in the settings
The AutoSize Iframe sizes the target website to the correct size. As users move through the target page the iframe resizes, thus giving the illusion that the the content on the page is continous. Two version of the Auto Size Iframe are available.
| Features | Enterprise | Lite |
|
| Autosize | 
|
|
| AutoSize Pause |
| |
| Default Width and Height |
| |
| Width and Height Buffer |
| |
| Dynamic URL |
| |
| Dynamic Width and Height |
| |
| Pass Through Variables |
| |
| Link to open Page |
| |
| User Security Ticket |
| |
| Alternate URL or HTML |
| |
| Search Index |
| |
| Addition Keywords |
| |
| Use Iframe or Get HTML from page |
| |
| Source is URL |
| |
| Page or Module on a Page |
| |
Settings Overview
Url
Specify the Url for the IFrame Source. If you select to display page there are options to display entire page or an individual module on that page. There are also options to show the skin and/or container.
Use IFrame*
You can now specify if the content will be displayed in an Iframe or if you wish the content to be pulled directly into your website.
Title
Title of IFrame Border Use IFrame border
Open Window Link Text
If you wish to add a link above the Iframe that will allow users to go to the target website in a new window, enter the text you wish the link to read.
(ei . “Goto Web Site”, “Click Here to View Website in New Window”
ScrollBars
There are three settings for the scroll bars
Auto – Only show the scrollbars when needed (javascript can resize the target page causing scrollbars to appear)
Yes – Always show the scrollbars
No – Never show the scrollbars
Enable Search*
Enabling search will allow the Dotnetnuke Search Engine to index the target page's content
Keywords
Entering keywords will be indexed in Dotnetnuke Search Engine.
Width Buffer
This setting adds pixels to the width of the iframe to allow for slight adjustments caused by JavaScript running on target page when the page is loaded.
Height Buffer
This setting adds pixels to the height of the iframe to allow for slight adjustments caused by JavaScript running on target page when the page is loaded.
Alternate*
In the event that the URL you are trying to set is not avaiable there is an option to set alternate content to display. There are three options to display alternate content: another URL, a page on your site, or HTML content (2000 characters Max). Enabling this option will cause the iframe to look for the content for the period of seconds specified in the "Timeout" setting. If the module is able to find content then it will be displayed, or else the alternate content will be displayed.
Link
There is an option to add a hyperlink to the target page. This will give the users the ability to view the content in a new window instead of the iframe window. Enter the Text you wish the hyperlink to be in "Open WIndow Link Text". Leaving this setting blank will disable the link from being shown. In the event that you wish to direct the user to another location you can specify a new url in the "Open Window Link Url" instead of the target page url.
Always Use Default Size
If this is checked then the AutoSize IFrame will use the Width and Height to size the frame.
Width – If Always Use Default Size is checked this will be the width of the IFrame, or if an error occurs while loading the IFrame.
Height – Same as Width except for height.
Auto Size Pause
Some pages may need a pause to load the targe page before it is sized. Typically this can be less than 50 milliseconds.
Note: if the target website url is set or changes to another domain (as in a link to another website is clicked) then the default Width and Height will be used.
Dynamic Query String Variables in Url
\[userid] in url will be replaced with current userid.
\[username] in url will be replaced with current username.
\[date(DATE_FORMAT)] Replace DATE_FORMAT with any date expression (ie MM/dd/yyyy).
See Valid Date/Time Formats Below. (Date and time based on Web Server Date and Time)
\[ticket] will create a unique key for the currently logged on user. This ticket is stored in the database table “DS_IFrameTicket“along with the user’s dnn id. Now in a custom application you can verify that the same user in the you are passing in with \[userid] has a valid ticket. The same ticket can be used for 30 minutes, after that a new ticket will be created for the user.
Query String Urls
This feature enables an iframe target url to change with a parameter passed in a query string. Create a link to the page that the iframe is on and use the query string "AU_IFRAME=" to pass in the url you want the target webpage to be. (ie. http://www.mysite.com?AU_IFRAME=http://www.mysite.com/forums/help). When an url is passed in by a query string and this feature is enabled it will override the url that is specified in the settings.
Date Time Formats(http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vblr7/html/vafmtuserdefineddateformats.asp)
* For sites running under Medium trust these options are not available for urls not in the domain.