") ); etag( "table" ); etag( "form" ); } function oik_action_notes() { p( "The actions output produced by " .bw_oik(). " actions can be used to find the sequence that actions are performed" ); p( "It needs to be used in conjunction with the trace facility."); p( "The oik actions should not need to be activated on a live site"); p( "If you do need to activate it, only do so for a short period of time." ); p( "You will need to specify the action file name (e.g. bwaction.loh )" ); p( "Set actions to 'on' when you want to trace action processing, 'off' otherwise"); p( "The trace action log is reset at the same time as the trace log" ); p( "You may find the most recent trace action output at..." ); $bw_action_url = bw_trace_url( 'bw_action_options' ); alink( NULL, $bw_action_url, $bw_action_url, "View action output in your browser."); bw_flush(); } function oik_action_reset_notes() { p(" to be written" ); } function oik_action_summary() { oik_require( "admin/oik-bwaction.inc" ); bw_action_summary(); } // Draw the menu page itself function bw_trace_options_do_page() { oik_menu_header( "trace options" ); oik_box( null, null, "Options", "oik_trace_options" ); oik_box( null, null, "Notes about oik trace", "oik_trace_notes" ); ecolumn(); scolumn( "w30pc" ); oik_box( null, null, "Trace options and reset button", "oik_trace_reset_notes" ); oik_box( NULL, NULL, "oik documentation", "oik_documentation" ); oik_box( NULL, NULL, "support oik", "oik_support" ); oik_menu_footer(); bw_flush(); } function oik_trace_options() { bw_form( "options.php" ); $options = get_option('bw_trace_options'); stag( 'table class="form-table"' ); bw_flush(); settings_fields('bw_trace_options_options'); bw_textfield_arr( "bw_trace_options", "Trace file", $options, 'file', 60 ); bw_checkbox_arr( "bw_trace_options", "Trace enabled", $options, 'trace' ); bw_checkbox_arr( "bw_trace_options", "Reset trace file every transaction", $options, 'reset' ); bw_checkbox_arr( "bw_trace_options", "Include trace record count", $options, 'count' ); bw_checkbox_arr( "bw_trace_options", "Include timestamp", $options, 'date' ); bw_checkbox_arr( "bw_trace_options", "Fully qualified file names", $options, 'qualified' ); //textfield( "bw_trace_options[trace]", 1 ,"Trace level (1=on)", $options['trace'] ); //textfield( "bw_trace_options[reset]", 1 ,"Trace reset (1=each txn)", $options['reset'] ); // Trace error processing is not yet enabled. // textfield( "bw_trace_options[errors]", 1 ,"Trace errors (0=no,-1=all,1=E_ERROR,2=E_WARNING,4=E_PARSE, etc)", $options['errors'] ); bw_tablerow( array( "", "") ); etag( "table" ); etag( "form" ); bw_flush(); } function oik_trace_notes() { p( "The tracing output produced by " .bw_oik(). " trace can be used for problem determination."); p( "It's not for the faint hearted."); p( "The oik-bwtrace plugin should not need to be activated on a live site"); p( "If you do need to activate it, only do so for a short period of time." ); p( "You will need to specify the trace file name (e.g. bwtrace.loh )" ); p( "When you want to trace processing check 'Trace enabled'" ); p( "Check 'Reset trace file every transaction' to cause the trace file to be cleared for every request, including AJAX requests" ); p("You may find the most recent trace output at..." ); $bw_trace_url = bw_trace_url(); alink( NULL, $bw_trace_url, $bw_trace_url, "View trace output in your browser."); p("If you want to trace processing within some content you can use two shortcodes: [bwtron] to turn trace on and [bwtroff] to turn it off" ); bw_flush(); } function oik_trace_reset_notes() { oik_require( "includes/oik-sc-help.inc" ); bw_invoke_shortcode( "bwtrace", null, "Use the [bwtrace] shortcode in a widget to provide an instant trace reset and page reload." ); } // Sanitize and validate input. Accepts an array, return a sanitized array. function bw_trace_options_validate($input) { // Our first value is either 0 or 1 //$input['option1'] = ( $input['option1'] == 1 ? 1 : 0 ); // Say our second option must be safe text with no HTML tags //$input['sometext'] = wp_filter_nohtml_kses($input['sometext']); return $input; } /** * Validate the bw_action_options * Note: If this function does not exist then no value is returned and the options don't get saved * WordPress does not produce a warning message. */ function bw_action_options_validate( $input ) { return $input; } function bw_trace_url( $option='bw_trace_options') { $options = get_option( $option ); $file = bw_array_get( $options, 'file', "$option.loh" ); $bw_trace_url = get_site_url( NULL, $file ); return( $bw_trace_url ); }