cgi::application::plugin::dbiprofile::graph::html(3pm) [debian man page]
CGI::Application::Plugin::DBIProfile::Graph::HTML(3pm) User Contributed Perl Documentation CGI::Application::Plugin::DBIProfile::Graph::HTML(3pm) NAME
CGI::Application::Plugin::DBIProfile::Graph::HTML - VERY basic pure html vertical bar graphing for CAP:DBIProfile. SYNOPSIS
# in httpd.conf SetVar CAP_DBIPROFILE_GRAPHMODULE CGI::Application::Plugin::DBIProfile::Graph::HTML PerlSetVar CAP_DBIPROFILE_GRAPHMODULE CGI::Application::Plugin::DBIProfile::Graph::HTML DESCRIPTION
This module is provided as a basic implementation of graphing for CAP:DBIProfile. It can be used as an example to develop other, more sophisticated, graphing solutions. GRAPH PLUGIN DEVELOPMENT
The graphing plugin must have a method called "build_graph", which must accept options as a hash. It should return a scalar or scalar ref holding the HTML output needed to generate your graph. The following options will be passed to the "build_graph" method: self The cgiapp object. mode_param $self->mode_param - the runmode variable used to determine runmode (useful for creating links back to ourselves). title A textual title for your graph. You don't have to use this, but is there if you want it. ylabel Label for values we're graphing. Either "Count" or "Seconds". data An array of the datapoints to graph. tags Labels for each datapoint which match the labels that will be used on the sql statement list (1 to however many items there are). The easiest graphs to implement are fully inline - ie. it doesn't need to make any external calls (no <image> or <embed> tags and such). CGI::Application::Plugin::DBIProfile::Graph::HTML is an example of this. Other possible candidates are Plotr and Open Flash Chart (using js interface to populate data). Another inline solution is to use the <img src="data:uri"> scheme. An example of this can be found in CGI::Application::Plugin::DBIProfile::Graph::GDGraphInline. Please note, this isn't supported under MSIE. In order to generate a graph that isn't inline, you'll need to pass the data to be graphed with your call to the external object. For example, if you want to use GDGraph, you could create a separate cgi script that returns graphs based on params passed to it, and return an approapriate image tag to from your graphing module. For example: <img src="/cgi-bin/graph.pl?data=20,14,42&tags=1,2,3"> Another way, would be to add a runmode in a CGI::Application "init" hook, and pass that runmode in a link back to the same script, and include your graph module in our script with a use statement. An example of this can be found in CGI::Application::Plugin::DBIProfile::Graph::SVGTT. REQUIREMENTS
L<HTML::Template> SEE ALSO
L<CGI::Application::Plugin::DBIProfile> L<CGI::Application::Plugin::DBIProfile::Graph::GDGraphInline> L<CGI::Application::Plugin::DBIProfile::Graph::SVGTT> AUTHOR
Joshua I Miller, L<unrtst@cpan.org> COPYRIGHT &; LICENSE Copyright 2007 Joshua Miller, all rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.12.4 2011-11-10 CGI::Application::Plugin::DBIProfile::Graph::HTML(3pm)
Check Out this Related Man Page
CGI
::Application::Plugin::AnyTemplate::Driver::HTMLTemplUserxContributed Perl CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplateExpr(3pm) NAME
CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplateExpr - HTML::Template::Expr driver to AnyTemplate DESCRIPTION
This is a driver for CGI::Application::Plugin::AnyTemplate, which provides the implementation details specific to rendering templates via the HTML::Template::Expr templating system. All "AnyTemplate" drivers are designed to be used the same way. For general usage instructions, see the documentation of CGI::Application::Plugin::AnyTemplate. EMBEDDED COMPONENT SYNTAX (HTML::Template::Expr) Syntax The HTML::Template::Expr syntax for embedding components is: <TMPL_VAR EXPR="CGIAPP_embed('some_run_mode', param1, param2, 'literal string3')"> This can be overridden by the following configuration variables: embed_tag_name # default 'CGIAPP_embed' For instance by setting the following value in your configuration file: embed_tag_name '__ACME_render' Then the embedded component tag will look like: <TMPL_VAR EXPR="__ACME_render('some_run_mode')"> The value of "embed_tag_name" must consist of numbers, letters and underscores ("_"), and must not begin with a number. CONFIGURATION
The CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplateExpr driver accepts the following config parameters: embed_tag_name The name of the tag used for embedding components. Defaults to "CGIAPP_embed". template_extension If "auto_add_template_extension" is true, then CGI::Application::Plugin::AnyTemplate will append the value of "template_extension" to "filename". By default the "template_extension" is ".html". associate_query This feature is now deprecated and will be removed in a future release. If this config parameter is true, then CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplateExpr will copy all of the webapp's query params into the template using HTML::Template::Expr's "associate" mechanism: my $driver = HTML::Template::Expr->new( associate => $self->query, ); By default "associate_query" is false. If you provide an "associate" config parameter of your own, that will disable the "associate_query" functionality. All other configuration parameters are passed on unchanged to HTML::Template::Expr. required_modules The "required_modules" function returns the modules required for this driver to operate. In this case: "HTML::Template::Expr". DRIVER METHODS
initialize Initializes the "HTMLTemplateExpr" driver. See the docs for CGI::Application::Plugin::AnyTemplate::Base for details. render_template Fills the HTML::Template::Expr object with "$self->param", and returns the output (as a string reference). See the docs for CGI::Application::Plugin::AnyTemplate::Base for details. SEE ALSO
CGI::Application::Plugin::AnyTemplate CGI::Application::Plugin::AnyTemplate::Base CGI::Application::Plugin::AnyTemplate::ComponentHandler CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplate CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplatePluggable CGI::Application::Plugin::AnyTemplate::Driver::TemplateToolkit CGI::Application::Plugin::AnyTemplate::Driver::Petal CGI::Application Template::Toolkit HTML::Template HTML::Template::Pluggable HTML::Template::Plugin::Dot Petal Exporter::Renaming CGI::Application::Plugin::TT AUTHOR
Michael Graham, "<mgraham@cpan.org>" COPYRIGHT &; LICENSE Copyright 2005 Michael Graham, All Rights Reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.10.1 2010-12-16CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplateExpr(3pm)