You are here: addons4webgui > Home > Macros
User: Visitor
Navigation
News
Login
Perl

Documentation

Perl Macro for WebGUI

What's this?:

With this WebGUI macro, it is possible to include and run Perl scripts in WebGUI.

System requirements:

  • Web server (tested on Apache 2).
  • WebGUI (tested on WebGUI V7.4.x).

Files:

  • WebGUI/docs/Macro_Perl.html: This document here.
  • WebGUI/lib/WebGUI/Help/Macro_Perl.pm: Help Text.
  • WebGUI/lib/WebGUI/Macro/Perl.pm: WebGUI macro.
  • WebGUI/lib/WebGUI/i18n/English/Macro_Perl.pm: Texts in english language.
  • WebGUI/lib/WebGUI/i18n/German/Macro_Perl.pm: Texts in german language.

Installation:

  1. Download the package source from http://sourceforge.net/projects/addons4webgui.
  2. Extract it (or copy the files from it) over the into your WebGUI install. Example: tar xvfz /path/to/Macro_Perl-x.x.x.tar.gz /path/to/WebGUI.
  3. Edit WebGUI conf file to add the Perl macro to the macro list.
  4. Restart web server.

Important notes:

  • On the page where the macro is inserted, set the cache timeout and the cache timeout (visitor) to zero!!!

Usage:

ˆPerl([Script]);

Example: ˆPerl("my $text = 'Hello '; return $text.$session->user->get('username');");

Macro parameter description:

  1. Script - perl script.

 

Troubleshooting:

See web server log file and/or webgui log file.

Changelog:

V1.0.1:
  • Renamed and updated this document
V1.0.0:
  • Migrated to WebGUI V7.4.x
V0.1.0:
  • First release
Copyright 2006-2008, studio4master
Licensed under the GNU General Public License (GPL) V3

http://addons4webgui.studio4master.ch

            Valid CSS!  
Running on WebGUI 7.6.25-s4m-20090617
Copyright (c) 2001-2009 by studio4master