Skip to end of metadata
Go to start of metadata

$html = LBWeb::logfile_button_html( @params );


Returns HTML code for a logfile button. This function accepts parameters from LBLog / LoxBerry::Log to open the lastest logfile, and also directly a logfile name.

LoxBerry Compatibility

This function is available starting with LoxBerry V1.2.1. If you use that function, set this minimum version in your plugin.cfg.

The function returns a string with HTML code that directly can be printed to your webpage.

The function accepts a LOGFILE parameter to directly give a filename, or the NAME parameter to use the log group name used in combination with the LBLog or LoxBerry::Log logging feature.

If you use the NAME parameter, the button will open the latest logfile available for the named group.

To give parameters to the function, use an array with named parameters. To send an array, inside the brackets of the function parameters logfile_button_html() open and close the array with square brackets []. See the examples below.


Case sensitivity

All parameter names are case-sensitive and written in capital letters.


LOGFILE is the fully filename of the logfile that should be opened.

The LOGFILE parameter is mutually exclusive to the NAME parameter. If you use LOGFILE, the NAME parameter is ignored.


NAME is the loggroup name used with LoxBerry::Log. If you have created a logfile with LoxBerry::Log::new( name => 'daemon'), use 'NAME' => 'daemon' to open the latest daemon log.

The NAME parameter is mutually exlusive to the LOGFILE parameter. If you use the LOGFILE parameter, the NAME parameter is ignored.


Package is not required in the case of a plugin. By default, this is (like with LoxBerry::Log) the $lbpplugindir-Variable.

Core-Developers have to use the PACKAGE parameter.


By default, LoxBerry labels the button with the language-specific "Logfile" phrase.

To change the default label, use the LABEL parameter.

DATA_MINIxBy default, the function uses the jQuery Mobile tag data-mini="true". To have the full-sized button, send 'DATA_MINI' => "0".
DATA_ICONxBy default, the function uses LoxBerry's default icon from jQuery Mobile, "action" (data-icon="action"). To change the icon, send the icon name here.

Return value

Returns a string that is the HTML code for the Logfile button. Simply echo the result of the function to your webpage.

Returns undef, if the call failed.


require_once "loxberry_web.php";
// Show a specific filename:
echo LBWeb::logfile_button_html( ['LOGFILE' => "$lbplogdir/mylogfile.log" ]);

# Show the latest log of LoxBerry::Log of a named group
echo LBWeb::logfile_button_html ( ['NAME' => 'daemon'] );

# Modify the label and the icon of the button:
echo LBWeb::logfile_button_html ( [ 'NAME' => 'daemon', 'LABEL' => 'Open my logfile', 'DATA_ICON' => 'arrow-r' ] );

  • No labels