QSM Extra Shortcodes - WordPress Plugin

Guide to Setting Up and Using QSM Extra Shortcodes

QSM Extra Shortcodes is for people who already use Quiz and Survey Master and want to display not just the quiz itself on pages, result screens, or in emails, but also calculated metrics: the number of attempts, pass and fail counts, average score, lists of popular or recent quizzes, summary counters, and formula-based calculations through [qsm_calc]. This guide focuses on the practical side of working with the add-on, not purchasing or promotional copy: where to find the shortcodes, how to choose the right parameters, how to verify the output, and what to do if the result looks wrong.

The key thing to understand about QSM Extra Shortcodes is that it is not a separate quiz builder. It is an extension for an existing QSM installation. That means the quality of the output depends not only on the shortcode itself, but also on the quiz data behind it: the correct quiz_id, the selected scoring model, completed submissions, email settings, the results page, and compatibility with your theme or caching setup.

This guide is written for site owners, instructional designers, marketers, and web admins who want to turn quiz results into clear public-facing blocks such as "128 people have taken this quiz," "the average score is 74%," "show the most popular quizzes," or "calculate participant efficiency using a formula." Developers will also find practical value here, especially around troubleshooting, safe output styling, and the limitations you should account for before rolling the add-on out on a live site.

What Problem the Add-On Solves and Where It Helps Most

Core QSM can create quizzes, questions, results, and emails. In practice, though, site owners often need to display additional data around a quiz. You might want to show attempt stats on a course page, social proof on a landing page, a personalized calculation in an email, or a list of recent or popular quizzes in a testing hub. That is exactly where QSM Extra Shortcodes becomes useful: it provides ready-made short inserts that pull from QSM data and return a specific metric.

It is important to understand the boundary of the product. The add-on does not replace analytics, it does not create a full user dashboard, and it does not produce advanced reporting on its own. It handles a more focused job: displaying individual numeric, list-based, or calculated fragments anywhere WordPress accepts shortcodes. That can be a page, post, quiz result screen, email template, or another site area, as long as the editor there actually processes shortcodes correctly.

Scenarios Where Shortcodes Deliver Quick Value

The first scenario is public statistics. If your site includes a quiz for certification, screening, self-assessment, or lead generation, you can show how many people have already taken it, what the average score looks like, and how many participants cleared the threshold. That kind of data can help orient the reader, but it should be presented carefully: it should not be framed as absolute proof of quiz quality.

The second scenario is navigation across multiple quizzes. A list of recent, popular, or all quizzes lets you build an "All Quizzes" page without manually updating links every time you publish new content. For a site with a large quiz library, that is much easier to maintain than a static list.

The third scenario is personalized feedback. [qsm_calc] lets you build a metric from QSM numeric variables: a percentage, coefficient, penalty, time-based efficiency score, category contribution, or another simple formula. That is especially useful in learning assessments, diagnostic questionnaires, and internal employee evaluations.

When the Add-On May Be More Than You Need

If your site only has one simple quiz and the standard results page is enough, QSM Extra Shortcodes may be unnecessary. It becomes valuable when the data needs to be reused: showing a summary block on another page, inserting a number into an email, building a quiz index, or calculating a value from multiple variables. If what you really need is deep analytics with filters, charts, exports, and scheduled reporting, you are better off looking at specialized QSM reporting add-ons or external analytics tools.

Practical rule: first define which metric the user should see, where it should appear, and how you will verify that the number is correct. Only then should you choose the shortcode.

What to Check Before Installing It on a Live Site

QSM Extra Shortcodes depends on the main Quiz and Survey Master plugin. That means preparation starts not with uploading the ZIP file, but by checking the foundation: is QSM installed, do you have quizzes with real attempts, is the scoring system clear, and are you relying on any outdated settings? The official add-on page lists the minimum QSM dependency, and the documentation describes installation as a standard WordPress plugin install followed by activation through the add-ons settings area.

Before adding anything to a live page, it is best to create a test post or a private page. Statistics shortcodes may return zero, an empty list, or an unexpected number not because the add-on is broken, but because the selected quiz has no results yet, the identifier is wrong, or the threshold is set to a value nobody has reached. Testing on a separate page saves time and reduces the risk of exposing an unfinished block to visitors.

Minimum Readiness Checklist

• The main Quiz and Survey Master plugin is installed and active.
• There is at least one published quiz that can be taken by a normal visitor.
• You know the quiz ID and understand where it is used as quiz_id in the shortcode.
• The quiz has test results, otherwise counters and averages may display an empty or zero state.
• You know what counts as a passing result: percentage, points, or another condition.
• The site is updated to current versions of WordPress, QSM, and related add-ons, because both the QSM changelog and the Extra Shortcodes changelog include security fixes and calculation-logic fixes.

Why Updates and a Backup Check Matter

These shortcodes work with quiz results and with parameters passed in through page content. That makes current security fixes especially important. The official Extra Shortcodes changelog includes entries about stronger validation, parameter whitelisting, and replacing unsafe evaluation in calculation shortcodes with safer math parsing. The main QSM changelog also includes fixes for XSS, IDOR, and SQL injection issues. You do not need to memorize version numbers for this guide, but before installation you should confirm that there are no pending updates in the WordPress admin.

A safe workflow looks like this: update the site on a staging copy, complete a test quiz, check the results page, the email, and the statistics page. If everything works, repeat the update on the live site during a normal maintenance window. If the site uses caching, a page builder, or JavaScript optimization, clear the cache after updating and check the output again in an incognito window.

Installation and the First Check in WordPress

QSM documentation describes two ways to install add-ons: through the QSM Addon Installer or manually as a standard WordPress plugin. In both cases, the logic is the same: the add-on should appear in the plugins list, activate successfully, and add its settings area inside the QSM interface. This guide does not cover licensing or purchasing, but it is important to know where the technical work begins once you already have the ZIP file or access to the add-on.

Installing Through the Plugins Interface

1. Open the WordPress admin and go to Plugins.
2. Click Add New, then Upload Plugin.
3. Select the add-on ZIP file and click Install Now.
4. After installation, activate the plugin with Activate Plugin.
5. Confirm that the plugins list includes an active item related to QSM Extra Shortcodes.

If the site uses QSM Addon Installer, part of the process happens inside QSM and its add-ons section. For a site owner, that is more convenient because installed add-ons, available packages, and settings all appear in one place. For troubleshooting, though, it is still useful to remember that WordPress should see the add-on as an active plugin.

What to Check Right After Activation

Once the add-on is enabled, open the QSM settings and locate the area related to Extra Shortcodes. The documentation describes a page that shows the list of available shortcodes and copy buttons. That detail matters: it is better to start by copying a ready-made template and then replacing the parameters than by typing the shortcode manually from scratch. That lowers the chance of missing a bracket, mixing up an attribute name, or leaving the demo value quiz_id=1 in place.

Your first test should be as simple as possible. Create a private page and insert, for example, the attempt counter for a specific quiz. After saving, open the page as a visitor. If you see a number, compare it with the result count inside QSM. If you see the shortcode text itself, the editor, block, widget, or insertion area is not processing shortcodes. If you see an empty space, start by checking the quiz ID and whether the quiz actually has saved results.

Quick takeaway: a successful installation is confirmed not just by an active plugin, but by a working shortcode output on a test page.

Shortcode Map: Which Metrics You Can Display

QSM Extra Shortcodes adds several groups of inserts. Some output counters, some return averages, some generate quiz lists, and some handle calculations or comparisons. When choosing one, start with the question "what result does the reader need to see?" rather than scrolling through every available option.

Attempt Counts, Pass Counts, and Fail Counts

The classic shortcode group shows how many times a quiz was taken, how many participants cleared the threshold, and how many did not. The documentation includes score-based and points-based variants, and newer descriptions consolidate those older separate shortcodes into [qsm_result_counts]. That is an important change: older inserts remain supported, but for new implementations the combined version is usually easier to work with if it is available in your version of the add-on.

The most common mistake in this group is mixing up percentages and points. If the quiz is configured as a percentage-based test, a threshold of 90 usually means 90 percent. If it uses a points model, that same 90 may mean 90 points. Before publishing, manually verify one real result and make sure the shortcode output matches the logic you expect.

Averages and Decimal Precision

You can display an average result through [qsm_average] and its related points-based variant. The documentation notes that the decimal parameter controls the number of digits after the decimal point. For a public-facing page, one or two digits is usually enough. Five digits may help during technical validation, but on a visitor-facing page they usually just create noise.

If the average looks odd, check the sample size. An average based on three test attempts should not be treated as stable statistics. On a training site or an HR assessment, it is better to add a short explanation to the page text: the metric updates as more attempts are completed and reflects the results of the selected quiz.

Lists of Recent, Popular, and All Quizzes

For a site with multiple quizzes, list shortcodes are especially useful. In the Extra Shortcodes documentation, the older [qsm_recent], [qsm_popular], and [qsm_all_quizzes] variants are described alongside the combined [qsm_quizzes] shortcode. The newer version supports parameters for quiz selection, list or grid view, sorting, limits, date range, and button text. At that point, it is no longer just "output a link" but a small quiz navigation block.

That kind of list works well on pages like "Quizzes," "Test Your Knowledge," "Course Materials," or "Popular Assessments." It does, however, need a sensible limit. If you output too many quizzes without a filter, the page becomes long and less useful. For a homepage, 3 to 6 items is usually a good range. For a dedicated catalog page, you can show more.

Calculated and Comparative Blocks

[qsm_calc] opens up the most flexible scenarios. It acts like an inline calculator for QSM numeric variables: you can calculate a percentage, weighted score, time-based efficiency, penalty for wrong answers, category contribution, or other simple formulas. The official documentation includes examples using %AMOUNT_CORRECT%, %AMOUNT_INCORRECT%, %POINT_SCORE%, %TIMER_SECONDS%, and similar variables.

The main rule here is not to overcomplicate it. If a formula is hard to explain to a site administrator in one sentence, it will also be hard to maintain. For public results, it is usually better to stick to one or two clear calculations and label them in plain language: "Completion Efficiency," "Correct Answer Rate," or "Score After Penalty."

Post-Install Setup: From Copying a Shortcode to Clean Output

The configuration workflow in QSM Extra Shortcodes starts on the page that lists the available inserts and their parameters. The documentation explicitly recommends using the copy button and then replacing the variable values. That is a solid working method: insert a known-good template first, then adjust the parameters one by one and test after every change.

Step 1. Find the Correct quiz_id

quiz_id is the central parameter for most inserts. If it is wrong, the shortcode may display zero, an empty block, or data from another quiz. The safest method is to open the quiz list in QSM and take the identifier directly from the interface, where it is visible in the settings or the URL. If the interface lets you choose a quiz through a settings icon next to the shortcode, use that instead of guessing manually.

After replacing the quiz_id, run one simple test: place [qsm_taken quiz_id=... ] on a private page and compare the number with the results in the admin. If the counter matches, you can move on to more advanced inserts.

Step 2. Configure Thresholds and Scoring Type

For pass/fail counters and [qsm_result_counts], check three things: which result type is being used, which value counts as the threshold, and which operator is needed. If you want to count participants who passed, you typically use a "greater than or equal to threshold" condition. If you want to show how many participants fell short of the threshold, you need the opposite condition. In the shortcode UI, that may be selected through settings; in a manual insert, it may appear as parameters such as operation and score_value.

Do not copy a threshold from another quiz automatically. A 10-question practice quiz and a 100-point exam use different scales. A good internal documentation habit is to note something like: "Quiz 42, passing threshold 75%, statistics displayed through score." That helps the next editor avoid breaking the block a month later.

Step 3. Limit Lists and Check Empty States

For [qsm_quizzes] and similar list outputs, the important settings are the limit, sort order, button text, and no-results message. If the page is meant to display popular quizzes, set a clear limit and test how the block looks when there is only a small amount of data. If the list is meant for a catalog page, think through the heading, the intro text, and where it sits on the page. The shortcode itself does not need to explain why those quizzes were selected. That is the job of the surrounding content.

The empty state matters just as much as successful output. If a date filter finds no quizzes, the user should see a clear message, not a blank area. In the combined shortcode documentation, a no-results text parameter is mentioned. Use it if it is available in your version.

Step 4. Adjust the Appearance Without Editing the Plugin

Most shortcodes return text, a number, a list, or a small block. Start by checking which CSS classes already exist in the final page HTML using your browser tools. If you need better spacing or want to highlight the statistics, do it through your theme styles, child theme, or a safe CSS plugin, not by editing QSM files directly.

A simple and reversible option is to wrap the shortcode in a page container:

<div class="qsm-extra-stats-box">
  <p>This quiz has already been taken <strong>[qsm_taken quiz_id=42]</strong> times.</p>
  <p>Average score: <strong>[qsm_average quiz_id=42 decimal=1]%</strong>.</p>
</div>

Then add CSS in a safe location, such as the theme settings or child theme:

.qsm-extra-stats-box {
  padding: 18px 20px;
  border: 1px solid #d8e3f0;
  border-radius: 8px;
  background: #f7fbff;
  margin: 24px 0;
}

.qsm-extra-stats-box p {
  margin: 0 0 8px;
}

.qsm-extra-stats-box p:last-child {
  margin-bottom: 0;
}

This snippet does not depend on the plugin's internal API and is easy to roll back: remove the container or the CSS, and the original shortcodes will keep working. Before publishing, check the page on a mobile screen, because long quiz lists and numeric blocks may need different spacing there.

Step 5. Check Caching and the Editor

If the site uses page caching, the statistics may not update immediately. That is not always a QSM Extra Shortcodes issue. The cache may be serving an older HTML version of the page where the number has not changed yet. For blocks with dynamic counters, check whether the page can be excluded from full-page caching or whether a slight delay is acceptable in that placement.

There is also a nuance with page editors. Most standard WordPress posts and pages process shortcodes correctly, but not every widget, custom HTML block, or builder field behaves the same way. If the shortcode appears as plain text, move it into a standard shortcode block or another area where WordPress definitely processes it.

Practical Example: A Statistics Block for a Certification Quiz Page

Imagine a site with an online course. The course page already includes a QSM quiz that checks understanding of the material. The goal is to add a clean block next to it showing how many times the test has been taken, how many participants reached the passing threshold, and what average result the group is getting. This is a realistic use case for QSM Extra Shortcodes because it uses exactly the type of data the add-on is built to display.

Goal

You want a small block before the quiz or after the intro text. It should motivate the participant, but it should not look like a promotional badge. The point of the block is to show activity and give a difficulty reference: "real people are taking this quiz, the average result looks like this, and the passing threshold is this."

Preparation

• The quiz is published and can be completed in a test run without errors.
• The quiz ID is known. In this example, we use 42.
• The passing threshold is set to 75 by score, not by points.
• There are at least a few test results so the average is not empty.
• The course page loads without conflicts from caching or the page builder.

Implementation Steps

1. Create a test copy of the course page or a draft.
2. Insert a container with three shortcodes: total attempts, pass-count above the threshold, and average result.
3. Replace quiz_id=42 with the real quiz ID.
4. Verify the threshold score_value="75" or the older score=75 parameter if you are using the older shortcode.
5. Save the page and open it in a separate browser as a regular visitor.
6. Compare the numbers with the QSM results section.

Example markup for the page:

<div class="qsm-extra-stats-box">
  <h3>Attempt Statistics</h3>
  <p>Total attempts: <strong>[qsm_taken quiz_id=42]</strong>.</p>
  <p>Reached the 75% threshold: <strong>[qsm_result_counts quiz_id="42" operation="greater_than" score_value="75"]</strong> participants.</p>
  <p>Average result: <strong>[qsm_average quiz_id=42 decimal=1]%</strong>.</p>
</div>

If your version of the add-on still uses the older shortcode set, replace the [qsm_result_counts] line with the variant confirmed in the interface, for example [qsm_passed quiz_id=42 score=75]. Do not mix the old and new parameter formats inside the same shortcode if the add-on UI shows a different structure.

Verifying the Result

Proper verification has two layers. First, the technical layer: the shortcodes are not visible as plain text, the block does not break the layout, and the numbers appear. Then the logical layer: the attempt count matches the results, the threshold is being evaluated on the correct scale, and the average is rounded to a readable number of digits. If all three values look believable, complete one more test attempt and see whether the counter changes after clearing the cache.

A Common Gotcha

On a fully cached page, the counter may not update instantly. For an educational course, that is often acceptable if the statistics do not need to change second by second. For a contest page where every fresh attempt matters immediately, it is better to exclude the page from cache or show the live activity in an administrative report instead of a public shortcode.

Calculations with [qsm_calc]: When a Formula Helps More Than a Ready-Made Counter

[qsm_calc] is best used not for every number, but for cases where a standard metric does not answer the real question. For example: "what percentage of attempted answers were correct," "how many points per minute did the participant score," "what penalty-adjusted result remains after subtracting incorrect answers," or "what contribution came from a specific category." The official documentation describes the shortcode as a way to perform arithmetic expressions with QSM numeric variables in results and emails.

Safe Formula Logic

The formula should be transparent. If you use it in a participant email, explain nearby what is being calculated. For example, "Efficiency shows how many points were earned per minute" or "Penalty-adjusted total reduces the score for incorrect answers." Without that context, the number looks arbitrary and may confuse users.

At first, choose formulas with two or three variables. Complex expressions with many categories are better handled in a separate methodology and tested against several known results in advance. If the result affects a certificate, access, employment, or another important decision, do not rely on a quick visual check alone: build a set of control attempts and calculate the expected values manually.

Examples of Clean, Practical Calculations

For a learning assessment, you can display accuracy:

[qsm_calc] %AMOUNT_CORRECT% / %AMOUNT_ATTEMPTED% * 100 [/qsm_calc]

For a timed quiz, you can show time efficiency:

[qsm_calc] %POINT_SCORE% / (%TIMER_SECONDS% / 60) [/qsm_calc]

For an exam with a penalty for wrong answers, you can use a simple penalty model:

[qsm_calc] %POINT_SCORE% - %AMOUNT_INCORRECT% * 2 [/qsm_calc]

These examples need to be adapted to your own quiz. If a variable is missing, returns an empty value, or does not fit that quiz's result model, the calculation will be wrong. That is why you should check the list of available QSM variables and test the formula against a real result before publishing.

Why [qsm_calc] Should Not Become Full Business Logic

The shortcode is convenient for displaying a result, but it should not replace a carefully designed evaluation system when money, course access, hiring decisions, or legal outcomes depend on it. In those cases, you need separate validation, logging, clear rules, and possibly custom development for the specific process. QSM Extra Shortcodes works well as a display and lightweight calculation layer, but not as a hidden engine for critical logic.

How to Place Metrics in Results, Emails, and Regular Pages

One reason QSM Extra Shortcodes needs careful implementation is that different output locations behave differently. A standard WordPress page, a QSM results screen, and an email template only look similar on the surface: in each one you insert text, but the available variables, processing order, and user expectations are different. If you drop the same shortcode into all three places without testing, you may get three different outcomes.

Standard Page or Post

On a regular page, a shortcode is most often used as a public statistics widget or a navigation block. There is no personal context for a specific participant there, so aggregated data usually works best: total attempts, average score, quiz lists, popular tests. The block should be self-contained. A visitor should understand which quiz the number belongs to, what the threshold means, and why the list looks the way it does.

On a standard page, it is helpful to add text before and after the shortcode. For example, instead of outputting only [qsm_average], write something like: "The current average score for this quiz is...". That helps both readers and search engines because the number becomes part of an explanation rather than a disconnected technical fragment.

Results Page

On the results page, the visitor has just completed the quiz, so the context is different. Here you can use shortcodes to compare the participant's personal result with the overall average, display extra calculations, or explain how many participants reached a similar threshold. The key is not to overload the user immediately after the test. If the standard QSM result already includes a score, message, correct answers, and buttons, the extra statistics should complement the output, not compete with it.

A good approach is to separate personal meaning from general context. First, show the participant's own result using standard QSM output, then add a short block such as "For reference, the average score on this quiz is..." or "The passing threshold has been reached by...". If you use [qsm_calc], label the formula in plain language. The user should not see a pile of variables and wonder why the number matters.

Email Template

Shortcodes in emails need especially strict testing. A web page is easy to reopen and fix. Once an email has been sent, it is already in the recipient's inbox. For every email scenario, complete a test attempt and send the message to several addresses. Check that the shortcode is processed, the number is not broken across line wraps, the HTML does not feel heavy, and the recipient can understand the metric without having to visit the site.

Email is not the best place for a long quiz list or complex statistics. In most cases, one or two metrics are enough: a personal calculation, an average reference point, or a link to the next quiz. If you need to show the full picture, it is usually better to link to the results page or a dashboard than to turn the email into a report.

Widgets, Theme Templates, and Page Builders

If you insert a shortcode into a widget, theme template, or custom builder field, first confirm that shortcodes are actually processed there. Some fields are intended for plain text only and never pass the content through the WordPress shortcode parser. The symptom is simple: the shortcode is displayed as text. In that case, do not try to "fix" QSM Extra Shortcodes. Change the insertion point or use the builder's native shortcode element.

The same shortcode can be used in different places, but every location should be tested separately: page, result, email, and template all have different context.

Migrating to Combined Shortcodes Without Breaking Older Pages

The Extra Shortcodes documentation describes "Optimized Merged Shortcodes," where several older inserts are consolidated into more flexible versions. For example, all, recent, and popular quiz lists can now be handled through [qsm_quizzes], while passed/failed counters by score and points can be handled through [qsm_result_counts]. At the same time, the documentation explicitly notes backward compatibility: the older shortcodes have not been removed, so existing sites can keep working.

That is good news, but it does not mean migration should be done randomly. If a live site already has dozens of pages using older shortcodes, do not replace them all at once. Start with a single page where the output is easy to verify, and run a side-by-side comparison: old shortcode, new shortcode, expected number from the admin. Only after that should you migrate the remaining blocks.

When It Makes Sense to Keep the Old Shortcode

You can keep the older shortcode if it works, is easy for the site's editors to understand, and does not create maintenance problems. That is especially reasonable on stable pages where the metric rarely changes or has already been validated by users. Rewriting it just for the sake of novelty adds no value unless there is a specific reason: a needed new parameter, a better configuration UI, a standardized format, or a fix for outdated logic.

When It Is Better to Move to the New Format

The newer combined shortcode is a better fit for new pages, quiz catalogs, and blocks that need extra parameters. For example, [qsm_quizzes] is more convenient than the older separate shortcodes when you need to choose a layout style, limit the number of items, set sorting, change the button text, or handle the empty state. [qsm_result_counts] is more convenient when an editor needs to explicitly choose the scoring type, operator, and threshold.

A Careful Migration Plan

1. Make a list of pages that use older Extra Shortcodes inserts.
2. Note the purpose of each insert: counter, average, list, or calculation.
3. For each group, identify the new equivalent using only the official documentation and the add-on interface.
4. Compare the old and new output on a private test page.
5. Roll out the changes in batches and clear the cache after each batch.
6. Leave an editorial note with a correct format example for future pages.

This approach matters even more if multiple editors work on the site. One person may keep using the old format out of habit, while another follows the new documentation. Without an internal note, the site will gradually end up with mixed formats, and troubleshooting will become harder.

Editorial Logic: How to Write Around Dynamic Numbers

The shortcode outputs a number or a list, but the meaning comes from the surrounding text. If you place "Average score: 84.2%" on a page with no explanation, a visitor may not know whether that is high or low, which quiz it refers to, or how to interpret it. That is why QSM Extra Shortcodes is best viewed as a data source for an editorial block, not as a ready-made mini page.

Explain the Metric Before You Display It

Give one sentence of context before the statistic: who took the quiz, what the threshold means, how often the data updates, and why the list is useful. You do not need to overload the page with methodology, but you do need a minimum level of meaning. For example: "This metric shows the share of participants who scored at least the passing threshold on the training quiz." After a sentence like that, the number reads as part of a result rather than a random figure.

Do Not Promise More Than the Shortcode Can Prove

An attempt counter does not prove course quality. An average score does not prove objective quiz difficulty. A popular quiz is not automatically the best one. It is better to use careful language such as "reference point," "based on saved results," "on this page," or "for the selected quiz." That protects the site from overstated claims and makes the guide more honest.

Separate Public Metrics from Internal Metrics

Not every number belongs on a public page. Safe public metrics include attempt counts, average scores, and quiz lists. Detailed answers, personal data, email addresses, individual user attempts, and internal results are better left inside the admin or specialized reports. If you are unsure, do not display the metric publicly until you have reviewed the site's policy and privacy settings.

Watch the Language of Buttons and Empty States

In quiz lists, button labels and no-results messages matter a lot. If the shortcode lets you define a button label or no-results text, use the language of the site. "Start Quiz" may be perfect on an English-language page, but on a Russian-language page you would naturally choose a local label unless it is a real admin UI label. At the same time, the technical shortcode parameters themselves stay in their original format.

Limitations You Should Know Up Front

QSM Extra Shortcodes has clear boundaries. Those limits do not make it weak, but they do help you choose the right scenario. If you account for them early, implementation goes more smoothly and editors do not expect a shortcode to do the job of a reporting module or custom development.

The Shortcode Can Only Display Data That Already Exists

The add-on does not create results out of thin air. If nobody has taken the quiz, aggregate metrics will be empty or zero. If the quiz was changed after some attempts were already completed, averages and counters may combine results recorded under different conditions. For important quizzes, after a major redesign you should decide whether to keep the old statistics as historical data or start a new page with an explanation.

Complex Reporting Requires a Different Tool

If you need date filters, user segments, exports, charts, group comparisons, and recurring reports, a single shortcode will be too limited. It can display one metric, but it cannot replace full analytics. The QSM ecosystem includes separate tools for reporting, exports, user dashboards, and leaderboards. Those are worth considering when the use case grows from a simple insert into a recurring operational task.

Formulas Need Maintenance

[qsm_calc] looks simple as long as the formula is short. A few months later, though, an editor may struggle to understand why a specific multiplier is being used, why an incorrect answer is subtracted with a factor of 2, or why time is divided by 60. If the formula matters, save a plain-English explanation of it and a few control examples alongside the project documentation.

Dynamic Numbers and Caching Do Not Always Work Well Together

Caching is a normal part of a WordPress site, but it may show an older version of a dynamic block. That is not always a problem. For social proof, a delay of a few minutes or even a few hours may be acceptable. For a contest or exam where freshness is critical, a public shortcode may be the wrong place to show that live result.

Use Cases: From a Course Page to a Quiz Catalog

The strength of QSM Extra Shortcodes is that it lets you reuse quiz data outside the standard results screen. Below are a few scenarios that are easy to adapt to different sites without inventing features the add-on does not actually have.

Course or Lesson Page

Before the quiz, you can show the number of attempts and the average score. That helps the student see that the quiz is actively used, and it helps the instructor add context without manually updating numbers. If the course is updated regularly, you can also display a list of recent quizzes on the topic through [qsm_quizzes] with a limited number of items.

Diagnostic Test Landing Page

For a diagnostic questionnaire, you can show "N people have taken this test" and "the group average is...". But phrase it carefully: the average should not read like a medical, psychological, or professional diagnosis if the test is not meant to provide one. "A reference point based on site participants" is usually a safer wording than "the norm."

Internal Knowledge Base

Inside a company or private training portal, a list of popular quizzes can show which assessments employees take most often. If the add-on is used alongside other QSM tools such as reporting or exports, public shortcodes can handle quick navigation while deeper analysis stays in the administrative area.

Results Email

If the insertion area supports QSM shortcodes and variables, a [qsm_calc] output can be used for a personalized comment. For example, the participant can receive not only a percentage but also a time-efficiency metric. Before launch, always send test emails to multiple inboxes and verify that the shortcode is processed instead of appearing as raw text.

How to Check the Output After Publishing

Output checks should be done regularly, especially if the statistics page matters for sales, training, or trust in the quiz. QSM Extra Shortcodes sits on top of QSM data, so any change to the quiz, scoring system, caching layer, results template, or plugin updates can affect what appears on the page.

Control Procedure After Changing a Shortcode

1. Open the page in admin mode and make sure the shortcode was inserted without typos.
2. Open the same page as a guest or in an incognito window.
3. Compare the attempt count, average result, or pass counter with the QSM data.
4. Clear the page cache if the site uses a caching plugin or server-side cache.
5. Complete one test attempt and check whether the expected value changes.
6. Check the mobile version, especially if the output includes a quiz list or a multi-line statistics block.

What Counts as a Successful Result

A successful result is not just the absence of an error. The block should be clear to the visitor, should not break the layout, should display data from the selected quiz, should round values correctly, and should not be misleading. If the average is based on a very small number of attempts, add context. If the quiz list is sorted by popularity, make sure popularity is actually the right criterion for that page.

A check of "the number appeared" is too weak. Verify the data source, the threshold logic, the visual presentation, and the behavior after a new attempt.

Compatibility with the Theme, Cache, Block Editor, and Emails

QSM Extra Shortcodes sits at the intersection of several WordPress systems: QSM stores the results, the shortcode processes the parameters, the editor renders the content, the theme styles the HTML, the cache may store the finished page, and the mail module may process email content in its own way. That is why compatibility checks need to go beyond "the plugin is active."

Block Editor and Page Builders

In the standard WordPress editor, it is best to use a shortcode block or a normal content block where the insert is definitely processed. In page builders, check whether there is a dedicated shortcode element. Do not place a shortcode into a field meant only for plain text if the builder does not process it.

Emails and Results Pages

The Extra Shortcodes documentation mentions inserting shortcodes into the results or emails tab, as well as into site posts and pages. But the actual behavior depends on the location. For emails, always send test messages. Check not only whether the shortcode is processed, but also whether the number is readable, whether line breaks look clean, and whether there is unnecessary HTML.

SEO and Indexability

By themselves, statistics shortcodes do not guarantee more search traffic. They can, however, make a page more useful by showing activity, connecting multiple quizzes, and adding context around a result. Do not rely on dynamic numbers as the only important content on the page. For SEO, it is better to have normal explanatory text nearby: what the metric means, how to take the quiz, who it is for, and what to do after seeing the result.

Security and Access Rights

Do not place internal data on public pages if visitors should not see it. QSM Extra Shortcodes is designed for displaying aggregate metrics and results, but the administrator is still responsible for the context. If a quiz is private, corporate, or contains sensitive data, check that the counter is not revealing more than it should about participant volume, activity, or internal assessments.

When QSM Extra Shortcodes Is the Right Choice

QSM Extra Shortcodes is a strong fit if you already run quizzes in Quiz and Survey Master and want to display their data in clear, useful places across the site: an attempt counter, average result, number of participants above a threshold, a list of recent or popular quizzes, or a simple formula inside a result screen or email. The add-on is especially useful when the standard quiz output already works, but the page still needs more context and live data.

Before publishing, run a short final check: verify the quiz_id, test results, threshold, shortcode processing, mobile appearance, and caching impact. If everything lines up, you can download the ZIP archive and test the add-on on a site copy or a private page.

Do not expect full analytics or a magical SEO boost. Its value is more specific: it lets you quickly and predictably display a specific QSM metric exactly where it helps the user make a decision, understand a result, or move on to the next quiz. That kind of targeted use case is what makes the add-on useful and safe for most WordPress sites that rely on quizzes.