Fork of WebGUI 7.10, maintained by Oqapi https://git.oqapi.nl/oqapi/webgui
Find a file
Scott Walters b962b03848 Making the "Copy Branch" menu option work was a treat.
requestHelper() invokes an asset helper via AJAX.  processPlugin() handles the JSON responses, which in this case is to open a dialog box and show
a given URL in it (openDialog key in the JSON hash).  that pop-up is open and the page loaded, and that displays a form.  that form submits
to an asset helper (uh oh) which also returns JSON (actually, it was failing to do even that and was stringifying a hash).  even if it returned
JSON, it would just get shown to the user in the pop-up.  so the form that gets loaded into the pop-up has to, onsubmit, after it has config
details from the user, run JS to make the AJAX request to the asset helper to start the actual copy operation, call into the admin's JS to
pop up the dialog that polls on a forked process, and then call into the admin to close itself.  this is a nasty hack that daisy chains
together two possible replies to processPlugin(), one after the other.
2013-09-25 15:00:45 -05:00
docs Revert "testenvironment does not check for correct perl version (#12377)" ... apparently this was either already done or done separately 2012-11-11 23:16:05 -05:00
eg Add a missing newline. 2010-06-24 08:43:12 -07:00
etc Remove admin console off link since it's trapped by the admin console and does nothing. 2013-09-11 09:54:32 -07:00
lib Making the "Copy Branch" menu option work was a treat. 2013-09-25 15:00:45 -05:00
sbin spectre.pl requires Devel::Size; wasn't tested for in testEnvironment.pl 2013-02-24 19:45:09 -05:00
selenium added install parameter 2012-09-20 14:55:10 -04:00
share Revert "when flipping between Tree and View tabs with edit on, clear out the containers for the toolbars before re-adding the toolbars -- this time in YUI" 2013-09-12 13:02:01 -05:00
t remove load of nonexistant, unused modules from a test 2012-11-17 15:59:33 -05:00
www WebGUI.Admin.prototype.reload: fix a lot of Tree view operations by doing a this.tree.goto on location.pathname rather than href to drop incidental 2013-09-25 15:00:44 -05:00
.gitignore Fixed #10967: Using a round bracket (parenthesis) in a macro. Unbalanced parentheses can now be escaped in macro calls using the backslash character. 2009-09-14 14:27:14 -04:00
.perltidyrc perltidyrc now placed where it can do the most good 2009-05-29 18:50:01 +00:00
.proverc adding proverc file 2010-06-13 06:15:34 -05:00
app.psgi use Plack::Util instead of relying on someone leaking it. 2012-02-10 08:30:31 -08:00
benchmark.pl Logging fallback 2010-04-13 17:46:43 -04:00
README more details in the concise instructions 2012-04-16 14:16:37 -04:00
TODO Minor improvements 2010-04-18 14:51:24 -04:00

This is the PSGI branch of WebGUI8

To try this out:

 0) Start from WebGUI 7.10.23 or the example .conf and create.sql that comes with WebGUI 8.
 1) Run testEnvironment.pl to install all new requirements.
 2) Get a new wgd from http://haarg.org/wgd
 3) Copy etc/WebGUI.conf.original to www.whatever.com.conf; edit it and set dbuser, dbpass, 
    dsn, uploadsPath (eg to /data/domains/www.example.com/public/uploads/), extrasPath, 
    maintenancePage and siteName
 4) Set WEBGUI_CONFIG to point at your new config file
 5) $ export PERL5LIB='/data/WebGUI/lib'
 6) $ wgd reset --upgrade
 7) $ cd /data/WebGUI (or whereever you unpacked it)
 8) $ rsync -r -a (or cp -a) /data/WebGUI/www/extras /data/domains/www.example.com/public/
    (from whereever you unpacked it to whereever you pointed extrasPath to; note 'extras'
    goes inside 'public', both under where extrasPath points to)

To start it:

 8) $ plackup app.psgi

See docs/install.txt for more detailed installation instructions.

Currently, the best performance is achieved via:

 plackup -E none -s Starman --workers 10 --disable-keepalive

You can benchmark your server via:

 ab -t 3 -c 10 -k http://dev.localhost.localdomain:5000/ | grep Req

I'm currently getting 370 requests/second, whereas I'm getting 430/second on the non-PSGI WebGUI8 branch.

= ARCHITECTURE =

* The root level app.psgi file loads all the config files found and
  loads the site specific psgi file for each, linking them to the
  proper host names.
* The site psgi file uses the WEBGUI_CONFIG environment variable to find the config.
* It instantiates the $wg WebGUI object (one per app).
* $wg creates and stores the WebGUI::Config (one per app)
* $wg creates the $app PSGI app code ref (one per app)
* WebGUI::Middleware::Session is wrapped around $app at the outer-most layer so that it can open and
  close the $session WebGUI::Session. Any other wG middleware that needs $session should go in between
  it and $app ($session created one per request)
* $session creates the $request WebGUI::Session::Request and $response WebGUI::Session::Response
  objects (one per request)