### PDF Certificate Generation Setup Source: https://blog.calendarscripts.info/using-certificates-in-watupro/ Details the process for enabling and configuring PDF certificate generation in WatuPRO. This requires installing a separate 'free PDF bridge' plugin and selecting specific options within the WatuPRO Certificates page. ```APIDOC PDF Certificate Configuration: 1. Install and activate the 'free PDF bridge' plugin. 2. Navigate to WatuPRO Certificates page. 3. Select the option to 'use PDF bridge' (visual indicator shown in documentation). 4. Configure PDF settings on the Add/Edit Certificate page: - Options typically include layout, branding, and specific PDF generation parameters. Note: PDF generation is handled by the bridge plugin, allowing for printable and downloadable certificates. ``` -------------------------------- ### WatuPRO GD Mode Pie Chart Shortcode Source: https://blog.calendarscripts.info/using-category-grades-in-watu-pro/ Enables the generation of pie charts using the GD library for image output, which is compatible with email and PDF. This mode requires the GD library to be installed on the server. ```html [watupror-pie-chart radius=150 from="points" mode="gd"] ``` -------------------------------- ### WatuPRO Shortcode Usage Example Source: https://blog.calendarscripts.info/watupro-4-6/ Demonstrates the usage of WatuPRO shortcodes for listing quizzes, with an optional argument to show user status. ```php // Example shortcode to list all quizzes with status for logged-in users // [watupro_quizzes show_status="true"] // Example shortcode to list quizzes in a specific category with status // [watupro_quizzes category="category_slug" show_status="true"] ``` -------------------------------- ### WatuPRO {{{button}}} Tag Usage Source: https://blog.calendarscripts.info/create-start-button-in-watupro-using-the-button-tag/ The {{{button}}} tag allows users to insert a custom HTML start button into WatuPRO quizzes. It can be placed in the quiz description. The tag supports customization of the button's text and CSS styles by passing arguments. ```WatuPRO Templating வாங்க {{{button}}} ``` ```WatuPRO Templating வாங்க {{{button "Start My Quiz Now"}}} ``` ```WatuPRO Templating வாங்க {{{button "Start My Quiz Now" "color:green;background-color:black;padding:20px;"}}} ``` -------------------------------- ### WatuPRO Theme Management (v6.1.9.5+) Source: https://blog.calendarscripts.info/design-themes-from-watupro-4-6-5/ Starting with WatuPRO version 6.1.9.5, users can create and manage custom themes directly through the WordPress administration interface. This is accessed via a link next to the theme selection dropdown. ```APIDOC WatuPRO Theme Management: Access: WatuPRO Settings page Feature: Create and manage custom themes directly in the administration. Availability: WatuPRO v6.1.9.5 and newer. Method: Look for a link "Create and manage your custom themes" next to the Theme drop-down. ``` -------------------------------- ### Example WatuPRO Personality Chart Shortcode Usage Source: https://blog.calendarscripts.info/personality-quizzes-in-watupro/ Demonstrates how to use the `watupro-personality-chart` shortcode with custom parameters for bar width, labels, and associative colors. ```html [watupro-personality-chart bar_width=250 label="{{personality-type}}" assoc_colors="1:#AA0070, 3:#B91ACC, 4:#C0FA9F"] ``` -------------------------------- ### WatuPRO Fix: Quiz Progress Bar Start Source: https://blog.calendarscripts.info/watupro-6-7/ Corrects an issue where the quiz progress bar did not start at 0% on the first page of a paginated quiz. ```javascript // Fix for progress bar initialization on first page. ``` -------------------------------- ### Troubleshooting Steps: Theme and Plugin Conflicts Source: https://blog.calendarscripts.info/watupro-front-end-troubleshooting-guide/ This section outlines the primary steps to diagnose front-end issues by isolating the cause to either the WordPress theme or another plugin. It involves systematically deactivating other components to identify the 'offending code'. ```text 1. Change your site theme to some of the default WP themes. - Reload the page with the quiz. - If problems solved: The issue is with your current theme's JavaScript. Contact the theme developer. - If problem not solved: Switch back to your theme and proceed to step 2. 2. Deactivate all plugins except WatuPRO. - Refresh the page with the quiz. - If problem solved: Reactivate plugins one by one, refreshing after each activation. - If the problem re-appears after activating a specific plugin: That plugin is the offender. ``` -------------------------------- ### Optimization and Caching Plugin Impact Source: https://blog.calendarscripts.info/watupro-front-end-troubleshooting-guide/ This documentation highlights the common pitfalls of using JavaScript/HTML minification and page caching plugins, which can interfere with WatuPRO functionality. It advises disabling these features for troubleshooting. ```text Disable 'optimization' plugins that 'minify' JavaScript and HTML code. - These plugins can cause fatal JavaScript errors due to improper minification. - Cloudflare's minification can also cause issues. Do not cache pages with quizzes that use randomization, timers, or are paid. - Caching these pages can lead to problems with quiz functionality. - Always purge the cache when quiz settings are changed, as cache plugins may not detect quiz setting updates. ``` -------------------------------- ### Custom Theme File Placement (Older WatuPRO) Source: https://blog.calendarscripts.info/design-themes-from-watupro-4-6-5/ For WatuPRO versions prior to 5.8.3, custom themes were implemented by uploading a CSS file. This CSS file should be placed within the plugin's specific theme directory. ```css watupro/css/themes/your-custom-theme.css ``` -------------------------------- ### WatuPRO Points-Based Pie Chart Shortcode Source: https://blog.calendarscripts.info/using-category-grades-in-watu-pro/ Generates a pie chart showing points collected per question category. The 'radius' parameter is optional and defaults to 100 pixels. ```html [watupror-pie-chart radius=150 from="points"] ``` -------------------------------- ### PDF Bridge Plugin Configuration Options Source: https://blog.calendarscripts.info/using-the-free-pdf-bridge-plugin-in-watupro/ Details configuration settings available for the PDF Bridge plugin within WatuPRO and Namaste! LMS, including options for page size, orientation, and background images. ```APIDOC WatuPRO/Namaste! LMS PDF Bridge Configuration: 1. Certificate Settings (Add / Edit Certificate page): - Page Size: Allows setting the paper size for generated PDFs (e.g., A4, Letter). - Orientation: Allows setting the page orientation (e.g., Portrait, Landscape). - Background Image: Supports placing a background image on PDF pages. 2. Quiz Settings (Edit Quiz page -> Quiz Output tab): - Print Final Screen: Option to enable quiz takers to print the final screen of their quizzes. Note: Namaste! LMS requires PDF Bridge version 0.7 or newer for these options to appear. ``` -------------------------------- ### WatuPRO Feature: Question Intros Source: https://blog.calendarscripts.info/watupro-6-7/ Adds the ability to include introductory text for questions, providing context or instructions before the question itself is presented. ```php // Feature for adding intros to questions. ``` -------------------------------- ### WatuPRO Intelligence Module: Dependencies Source: https://blog.calendarscripts.info/watupro-changelog-archive/ The Dependencies section within the Intelligence module now supports 'all' or 'any' modes. This allows administrators to specify whether all prerequisite conditions must be met or if satisfying just one is sufficient for a quiz or question to become available. ```APIDOC Dependencies: mode: "all" | "any" (Specifies if all or any of the listed dependencies must be satisfied) ``` -------------------------------- ### WatuPRO PDF Generation with PDF Bridge Source: https://blog.calendarscripts.info/watupro-5-5/ When the PDF Bridge plugin is installed and enabled for generating certificates, clicking the 'Download' link on the 'View results' popup will now generate PDF files. Previously, it generated .doc files if the PDF Bridge was not installed. ```PHP // Conceptual representation of the conditional logic // if (pdf_bridge_enabled()) { // generate_pdf_certificate(); // } else { // generate_doc_certificate(); // } ``` -------------------------------- ### WatuPRO File Download Options Source: https://blog.calendarscripts.info/watupro-6-0/ Users can now choose the view format for downloaded files from quiz attempts. Options include 'snapshot' (default) or 'table'. The file format can also be selected, defaulting to '.html' instead of the previous '.doc'. ```APIDOC File Download Settings Description: Configures the view and format of downloaded quiz attempt files. Options: - View: - snapshot (default) - table - File Format: - .html (default) - .doc (problematic, replaced by .html) Note: - PDF files can be generated using a free PDF bridge. Example: (Setting within WatuPRO General Settings -> Downloaded Files) Related: - Open-end question file uploads ``` -------------------------------- ### WatuPRO Variables Source: https://blog.calendarscripts.info/watupro-changelog-archive/ Custom variables that can be used in WatuPRO to display dynamic quiz data, such as points, start time, and end time. These are typically used in final screens or result displays. ```APIDOC %%POINTS-ROUNDED%% - Displays the points collected on a quiz rounded without decimals. %%START-TIME%% - Displays the time when the quiz was started. %%END-TIME%% - Displays the time when the quiz was completed. ``` -------------------------------- ### WatuPRO Templating Variables Source: https://blog.calendarscripts.info/watupro-changelog-archive/ Variables that can be used in quiz final screens, email content, or certificates to display dynamic user or quiz data. These variables are placeholders that get replaced with actual values during runtime. ```APIDOC %%USER-NAME%% - Description: Displays the user's name. - Source: Uses the value entered in the {{{name-field}}} placeholder. If {{{name-field}}} is empty, it displays the logged-in user's name. If the user is not logged in, it displays "Guest". - Usage: Final screen, email content. %%AVG-POINTS%% - Description: Shows the average points achieved by other quiz takers for the current quiz. - Usage: Final screen, email content. %%AVG-PERCENT%% - Description: Shows the average percentage of correct answers achieved by other quiz takers for the current quiz. - Usage: Final screen, email content. %%TIME-SPENT%% - Description: Displays the time spent by the user while taking the test. - Usage: Final screen. %%USER-NAME%% - Description: Displays the user's name. - Source: Uses the value entered in the {{{name-field}}} placeholder. If {{{name-field}}} is empty, it displays the logged-in user's name. If the user is not logged in, it displays "Guest". - Usage: Final screen, email content. %%POINTS%% - Description: Displays the points earned by the user for a specific question. - Usage: 'Optional answer explanation' field for questions. ``` -------------------------------- ### WatuPRO Dependencies & Conditions Source: https://blog.calendarscripts.info/watupro-6-3/ Configuration options for setting dependencies between quiz questions or conditions for re-submitting quizzes. ```php // Added "% of max. Points" as new dependency type for Dependencies. // In the condition "Re-submitting is allowed only if some of the following grades is achieved", // added "None (no grade achieved)" as an option. ``` -------------------------------- ### Integration and API Features Source: https://blog.calendarscripts.info/watupro-changelog-archive/ Information on new integrations and API-related features, including MoolaMojo for virtual currency awards, Tin Can/Experience API integration, and delayed display of test results. ```APIDOC MoolaMojo Integration: Description: Award virtual currency for taking tests through MoolaMojo integration. Reference: https://namaste-lms.org/moola-mojo/ Tin Can / Experience API Integration: Description: Integrates with the Tin Can API (xAPI) via the WP Experience API plugin. Reference: https://namaste-lms.org/experience-api/ Delayed Test Results Display: Description: Option to delay the display of test results to a future date. Allows defining custom text shown before the date arrives for logged-in users. Configuration: Date and text for delayed results display. ``` -------------------------------- ### WatuPRO Bug Fix: Contact Fields Scroll Source: https://blog.calendarscripts.info/watupro-changelog-archive/ A bug that prevented automatic scrolling to contact fields when requested at the end of a quiz on certain installations has been resolved. This improves the user experience on long quiz pages. ```APIDOC BugFix: - "Quiz taking: Fixed issue where contact fields did not auto-scroll into view on long pages." ``` -------------------------------- ### WatuPRO Plugin - WP QuickLaTeX Integration Source: https://blog.calendarscripts.info/watupro-changelog-archive/ Enables the use of WP QuickLaTeX plugin's features within WatuPRO quizzes, allowing for LaTeX formatting of content. ```APIDOC WP QuickLaTeX Integration: Description: WatuPRO now includes filters that support the WP QuickLaTeX plugin. This allows users to leverage LaTeX syntax for mathematical equations, scientific notation, and other complex formatting within quiz questions and content. Requirement: WP QuickLaTeX plugin must be installed and active. Usage: Content formatted with WP QuickLaTeX shortcodes or syntax will be rendered correctly within WatuPRO. ``` -------------------------------- ### WatuPRO User Category Chart Shortcode Source: https://blog.calendarscripts.info/using-category-grades-in-watu-pro/ Embeds a chart displaying user category performance. The shortcode accepts parameters explained in the plugin's internal help page. ```html [watupror-user-cat-chart] ``` -------------------------------- ### PDF Bridge Troubleshooting: Blank Page/Server Errors Source: https://blog.calendarscripts.info/using-the-free-pdf-bridge-plugin-in-watupro/ Addresses common causes for blank pages or server errors when using the PDF Bridge plugin, primarily related to missing PHP extensions. ```APIDOC Troubleshooting PDF Bridge Blank Page / Server Errors: Problem: Blank pages or server errors during PDF generation. Most Common Cause: The PHP 'mbstring' extension is not enabled on your server. MPDF requires this extension. Resolution: - Ensure the 'mbstring' PHP extension is enabled. Consult your hosting provider or server administrator if unsure. If 'mbstring' is enabled and errors persist: - Obtain specific error information from your server's error log or from errors displayed on the screen. - Review MPDF documentation for other potential causes or specific error messages. ``` -------------------------------- ### WatuPRO Shortcode: Quiz Attempt Counter Source: https://blog.calendarscripts.info/watupro-changelog-archive/ The `watupro-quiz-attempt` shortcode displays the number of attempts allowed or remaining for a specific quiz for the current user. Usage examples are available within the plugin's internal Help page. ```WordPress Shortcode watupro-quiz-attempt ``` -------------------------------- ### WatuPRO Multi-Quiz Performance Variables Source: https://blog.calendarscripts.info/performance-on-multiple-quizzes-and-conditional-content-in-watupro/ Lists the available variables that can be used within the `watupro-multiquiz` shortcode to display specific performance metrics. These variables are placeholders that get dynamically replaced with calculated values. ```APIDOC WatuPRO Multi-Quiz Variables: %%MULTI_POINTS%% - Description: The total points collected by the user across all specified quizzes. - Type: Integer %%MULTI_PERCENTAGE%% - Description: The average percentage of correct answers given by the user across all specified quizzes. - Type: Float (e.g., 75.5) %%MULTI_PERCENTAGEOFMAX%% - Description: The average percentage of points achieved from the maximum possible points for each quiz. Calculated per quiz attempt and then averaged. - Type: Float (e.g., 88.2) %%MULTI_CORRECT%% - Description: The total number of correct answers given by the user across all specified quizzes. - Type: Integer %%MULTI_WRONG%% - Description: The total number of wrong answers given by the user across all specified quizzes. - Type: Integer %%MULTI_EMPTY%% - Description: The total number of unanswered questions by the user across all specified quizzes. - Type: Integer %%MULTI_MAX-POINTS%% - Description: The total maximum points possible from all specified quizzes and all attempts. - Type: Integer ``` -------------------------------- ### PDF Bridge Font Configuration Source: https://blog.calendarscripts.info/using-the-free-pdf-bridge-plugin-in-watupro/ Instructions for manually managing fonts for the PDF Bridge plugin, particularly for supporting additional languages or a full font set. ```APIDOC Manual Font Management for PDF Bridge: To include all fonts (e.g., for Chinese, Japanese languages) or if using a stripped-down MPDF version: 1. Download Fonts: - Manually download fonts from: https://github.com/mpdf/mpdf/tree/development/ttfonts - Upload these fonts to the following directory: pdf-bridge/lib/vendor/mpdf/mpdf/ttfonts 2. Modify Configuration File: - Open the file: /pdf-bridge/lib/vendor/mpdf/mpdf/src/Config/ConfigVariables.php - Locate and change the following lines: - Line 96: Change 'autoScriptToLang' => false to 'autoScriptToLang' => true - Line 101: Change 'autoLangToFont' => false to 'autoLangToFont' => true Alternatively, for older PHP versions, version 1.4.3 of the PDF Bridge plugin includes a fuller font set. ```