Mamba Quiz CSV Import for Tutor LMS

by Mamba Coding

Description

Mamba Quiz CSV Import for Tutor LMS helps administrators import multiple-choice questions from a CSV file into an existing Tutor LMS quiz. The destination is selected in the order Course Topic Quiz, and existing quiz questions are kept unchanged.

Mamba Quiz CSV Import is an independent plugin by Mamba Coding and is not affiliated with, endorsed by, or sponsored by Themeum or Tutor LMS.

CSV format

The first row must use sequential columns in this format:

Question, Answer 1, Answer 2, Answer 3, ... Answer N

Question, Answer 1, and Answer 2 are required.
Answer 1 is imported as the correct answer.
Add as many further sequential columns as needed: Answer 3, Answer 4, Answer 5, and so on.
Additional answer cells may be empty for individual questions.
The downloadable sample demonstrates questions with different numbers of answers.
Common comma, semicolon, tab, and pipe delimiters are detected automatically.
UTF-8 CSV files are recommended. Common UTF-16 exports are converted when the server supports the required PHP extension.
Quoted delimiters and multiline fields are supported.

Imported questions use these documented settings: answer order is not randomized, an answer is required, each question is worth 1 point, and the point value is shown.

The plugin has no time limit and no usage quota. Operational safeguards limit a single request to a 10 MB file and 10,000 data rows to reduce the risk of server timeouts on shared hosting. Developers can adjust the file-size safeguard with the mctqi_max_import_file_size filter.

Separate Premium add-on

A separately distributed Premium add-on is available outside WordPress.org. Its code is not included in this plugin. It provides different import workflows, including:

XLSX file support
CSV files with arbitrary column names and column order
Visual column mapping
File preview before import
Custom answer randomization, answer-required, score, and score-visibility settings
Exact duplicate-question detection
Private automatic updates and Premium support

A compact product-information link is shown only within Mamba Quiz CSV Import administration screens and the plugin row.

Requirements

WordPress 6.2 or later
PHP 7.4 or later
Tutor LMS installed and active

Installation

Upload the plugin folder to /wp-content/plugins/, or install it from the WordPress Plugins screen.
Install and activate Tutor LMS.
Activate Mamba Quiz CSV Import for Tutor LMS.
Open Mamba Quiz CSV Import in the WordPress administration menu.
Download the sample CSV and add or remove sequential Answer N columns as needed.
Select the destination course, topic, and quiz, then import the file.

Screenshots

Standard CSV import screen showing the sample-file download, the Tutor LMS Course → Topic → Quiz destination selectors, the CSV upload field, and the Import questions button.
Example CSV opened in a spreadsheet. The first column contains the question, Answer 1 is always the correct answer, Answer 2 is required, and further sequential Answer N columns may be added or left empty for individual questions.

Faq

Does the plugin delete or replace existing quiz questions?

No. Imported questions are appended to the selected quiz.

Which answer is marked as correct?

Answer 1 is always marked as correct. The plugin creates multiple-choice questions with one answer flagged as correct.

How many answer options can a question have?

There is no fixed answer-option limit in the CSV format. Include at least Answer 1 and Answer 2, then add sequential columns such as Answer 3, Answer 4, Answer 5, and so on. Optional cells may be empty on rows that need fewer answers.

Must all rows contain the same number of answers?

No. The header defines the available answer columns, but unused optional answer cells can remain empty for individual questions.

Can I rename or reorder the CSV columns?

The free plugin uses a predictable standard format, so the columns must remain sequential: Question, Answer 1, Answer 2, and so on. Arbitrary headers and visual mapping are a separate workflow provided by the separately distributed Premium add-on.

Can I import XLSX files?

This plugin imports CSV files. XLSX parsing and visual column mapping are provided by the separate Premium add-on, whose code is not included in the WordPress.org plugin.

Why is there a 10,000-row safeguard?

The safeguard reduces the likelihood of PHP timeouts and exhausted memory during a single synchronous request, especially on shared hosting. It is an operational safety measure, not a usage quota: the plugin can be used repeatedly without limit.

Does the destination quiz need to exist before importing?

Yes. Create the Tutor LMS course, topic, and quiz first. The importer only adds questions to an existing quiz and lets you select the destination in the order Course Topic Quiz.

What happens to rows with missing required content?

Rows without a question, Answer 1, or Answer 2 are skipped. After the import, the plugin reports both the number of questions imported and the number of skipped rows.

Can I import the same CSV more than once?

Yes, but the free plugin appends the questions again and does not check for duplicates. Exact duplicate detection is available in the separately distributed Premium add-on.

What happens if a database error occurs during import?

The import is rolled back. Questions created by the failed operation are removed, so the quiz is not left with a partial import.

Can questions or answers contain commas, delimiters, or line breaks?

Yes. Use a correctly formatted CSV file with quoted fields. The parser supports quoted delimiters and multiline fields and automatically detects common comma, semicolon, tab, and pipe separators.

Does the plugin send data to an external service?

No. CSV parsing and question creation happen locally on the WordPress site.

Reviews

Changelog

2.0.6

Renamed the plugin to Mamba Quiz CSV Import for Tutor LMS.
Changed the WordPress.org slug and text domain to mamba-quiz-csv-import-for-tutor-lms.
Updated the plugin folder, main file, administration labels, documentation, and translation template.
Retained unrestricted support for any number of sequential Answer N columns in the free CSV importer.

2.0.5

Added support for any number of sequential Answer N columns in the free CSV importer.
Removed the previous two-to-four-answer restriction and all related Premium comparisons.
Improved CSV parsing for quoted delimiters and multiline fields.
Replaced the repeating administration notice with a compact product-information panel limited to the importer screen.
Removed license-related wording and links from the free plugin.
Clarified that Premium functionality is supplied only by a separate add-on whose code is not included in the WordPress.org package.
Updated the sample CSV, documentation, translations, and plugin metadata.

2.0.4

Added an explicit independent-integration trademark disclaimer.

2.0.1

Added a required topic selector between the course and destination quiz.
Quiz choices are filtered to the selected Tutor LMS topic.
Added server-side validation of course, topic, and quiz relationships.

2.0.0

Introduced a Free/Premium add-on architecture.
Added standard CSV import and a downloadable sample.
Added a dedicated Premium information page and extension hooks for a separately distributed add-on.
Retained nonce checks, file validation, transactional database writes, and rollback protection.