X-Include

Note: The recipes here are for PmWiki versions 0.6 and 1.0 only. For PmWiki 2.0 recipes, see Cookbook.


Description

This add-on allows a PmWiki user to include the contents of any external webpage in a WikiPage. This new version (release May 17, 2004) introduces a site filter whereby the administrator may specify which website urls are to trusted sites.


See Also

  • The includeurl.php script in the PmWiki distribution

Author(s)

Installation

  1. Save the file x-include.php.txt to pmwiki/local/scripts
  2. Rename the file to x-include.php
  3. Next, add this line to your config.php file:
    include_once("local/scripts/x-include.php");
  4. That's it!

Download

Download the file x-include.php.txt here. Don't forget to rename it to x-include.php after downloading.

Documentation

Full documentation and installation instructions are included in the script.

History

  • May 17, 2004 - Added support for admins to allow all, or some websites. These "safe sites" are maintained in "list", stored either directly in this sciprt, or in a protected WikiPage.
  • Apr 6, 2004 - Improved cpu and memory usage by putting all code and variables in to functions.
  • Mar 30, 2004 - Slight enhancement to the way the script preserves the url in the <iframe> tag so that PmWiki doesn't fiddle with it (using the Keep() function). Thanks to Pm for pointing that out to me.
  • Mar 22, 2004 - Added support for user-specified DefaultValues.
  • Mar 20, 2004 - First released.

User Question

Is there a way to avoid this iframe construction? For I dont want external pages, I want to include local php files. (Stefan Beck)

I think it could be done. I don't mind taking a crack at it, but it would help if you gave more details (or an example) of what you would use it for, and how you would use it. I'd prefer you to email me directly as I rarely check these pages for replies. My email address is in the script file. (Steven Leite)

Q. While using Easy Templates I was wanting to know if I can include contents of another web document - similar to wiki:group.pagename style directly into a template. This way I would be able to pull a content permanenantly on to group of pages particular to a group. I can use the includeurl.php but than would have to mention a line in each page. With inclusion in template security wise it can be more safe as it is not directly editable by wiki users...I guess. (V.Krishn) pmwiki-2.2.120 -- Last modified by {{}}?

from IP: 85.171.160.186 ip should be disabled by default for security reasons