one per background iteration<\/strong>, instead of all at once.<\/p>\n\nIt does not<\/strong> modify Tainacan core \u2014 it registers an additional importer through the tainacan-register-importers<\/code> hook, so it keeps working across Tainacan updates.<\/p>\n\nThis is an independent add-on developed by Bauhaus Tech. It is not affiliated with, endorsed by, or part of<\/strong> the Tainacan project.<\/p>\n\nThe problem it solves<\/h4>\n\n
A CSV import in which a single item has many attachments (e.g. 150 images in special_attachments<\/code>) fails with:<\/p>\n\nPHP Fatal error: Maximum execution time of 360 seconds exceeded in ...\/class-wp-image-editor-imagick.php\n<\/code><\/pre>\n\n\u2026and then restarts from the beginning, duplicating items<\/strong>.<\/p>\n\nThe stock Tainacan CSV importer imports all<\/strong> of an item's attachments inside a single after_inserted_item()<\/code> call. Each file triggers wp_generate_attachment_metadata()<\/code>, which generates thumbnails through Imagick \u2014 an expensive operation. The background process only checks its soft time limit (~20s) between<\/strong> task()<\/code> iterations; since the 150 attachments run inside a single iteration, that limit is never checked mid-loop. The item alone exceeds PHP's hard max_execution_time<\/code>, the process dies mid-task without persisting progress<\/strong>, and the cron healthcheck re-dispatches the batch from the last checkpoint<\/strong> \u2014 recreating already-imported items.<\/p>\n\nHow it works<\/h4>\n\n
Instead of importing attachments inline, this importer:<\/p>\n\n
\n- Queues<\/strong> the item's attachment paths\/URLs (stored in a transient serialized together with the process state).<\/li>\n
- Processes one attachment per iteration<\/strong>, staying on the current item until the queue is empty.<\/li>\n<\/ol>\n\n
Because each attachment becomes its own iteration, the soft 20s limit applies between files<\/strong>: the batch checkpoints regularly and the import becomes resumable. Idempotency is reinforced by persisting the already-created item id, so a resume continues the attachments instead of recreating the item.<\/p>\n\nKnown limitations<\/h4>\n\n
Because this plugin cannot modify Tainacan core<\/strong>:<\/p>\n\n\n- A single file whose processing alone exceeds
max_execution_time<\/code> still fails (pathological case).<\/li>\n- Progress is still persisted at the core's ~20s
handle()<\/code> checkpoint, not per iteration (forcing a per-iteration checkpoint would require changing Background_Importer::task()<\/code> in core). A fatal within the same 20s window<\/strong> may reprocess what was done since the last checkpoint. The definitive fix is the equivalent change upstream in Tainacan.<\/li>\n<\/ul>\n\n\n\n- Upload the
csv-resumable-importer-for-tainacan<\/code> folder to \/wp-content\/plugins\/<\/code>, or install the ZIP via Plugins \u2192 Add New \u2192 Upload Plugin<\/strong>.<\/li>\n- Activate CSV Resumable Importer for Tainacan<\/strong> in Plugins<\/strong>.<\/li>\n
- Requires the Tainacan<\/strong> plugin to be installed and active.<\/li>\n
- In Tainacan \u2192 Importers<\/strong>, choose \"CSV (resumable attachments)\"<\/strong> instead of the default CSV importer.<\/li>\n<\/ol>\n\n\n
\nDoes it modify Tainacan core?<\/h3><\/dt>\nNo. It registers an additional importer through Tainacan's tainacan-register-importers<\/code> hook and subclasses the core CSV importer. Tainacan updates do not overwrite it.<\/p><\/dd>\nAre the import options different from the native CSV importer?<\/h3><\/dt>\nNo. Delimiter, mapping, server_path<\/code> and the special columns (special_document<\/code>, special_thumbnail<\/code>, special_attachments[|APPEND|REPLACE]<\/code>) work exactly as in the native importer. Only the way attachments are processed changes.<\/p><\/dd>\nIs this an official Tainacan plugin?<\/h3><\/dt>\nNo. It is an independent add-on by Bauhaus Tech, not affiliated with the Tainacan project.<\/p><\/dd>\n
Does it fix every possible timeout?<\/h3><\/dt>\nIt removes the real-world cause (a single item importing many attachments in one uninterruptible call). See \"Known limitations\" for the residual edge cases that would require a core change.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.0.0<\/h4>\n\n\n- Initial release. Resumable CSV importer that processes
special_attachments<\/code> one per background iteration.<\/li>\n<\/ul>","raw_excerpt":"Resumable CSV importer for Tainacan: imports attachments one at a time to avoid execution timeouts and duplicate items on large imports.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/329611","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=329611"}],"author":[{"embeddable":true,"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/bauhaustech"}],"wp:attachment":[{"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=329611"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=329611"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=329611"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=329611"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=329611"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/fr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=329611"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}