Description
This plugin lets you automatically import eSIM plans from an external API into your WooCommerce store. It creates both grouped and simple products, manages metadata for SEO, and delivers eSIM details, QR codes, manual installation details, and eSIM Passport links to customers via email upon order completion.
Main features include:
- Auto-import of eSIM plans via API
- Creation of grouped and simple WooCommerce products
- SEO-friendly meta tags and product descriptions
- One-click synchronization from the WordPress admin panel
- Automatic email delivery after WooCommerce order completion
- ICCID delivery via customer email
- Manual eSIM installation details
- QR code delivery for eSIM installation
- eSIM Passport link support
- WooCommerce mailer integration with fallback to
wp_mail() - Automatic customer language detection during WooCommerce checkout
- Language persistence in the order metadata
- Compatible with WPML, TranslatePress, Polylang and similar multilingual plugins
- English fallback when no supported language is available
- Multi-language customer email templates
Supported email languages:
- English — default fallback language
- German
- Spanish
- Czech
Email localization includes:
- Email subject
- Main email heading
- Greeting and intro text
- Order summary section
- eSIM details section
- eSIM Passport section
- QR code section
- Manual installation instructions
- Support message
- Footer message
Language resolution order:
- Language resolved from the multilingual website context during checkout
- Stored order language metadata
- WordPress site language
- English fallback
All dynamic email values remain unchanged across all language versions, including:
- Order ID
- Order total
- Currency
- ICCID
- SM-DP+ Address
- Activation Code
- Confirmation Code
- LPA Code
- Plan ID
- Expiration date
- Remaining data
- QR code
- eSIM Passport link
During activation, the plugin:
- Creates necessary folders in the WordPress uploads directory for secure data storage
- Registers
[yesim_grouped_products]shortcode - Creates the page
/yesim-grouped-products/with the shortcode - Initializes email delivery support
External Services
This plugin connects to external services to provide its core functionality. By using this plugin, you acknowledge that certain data will be sent to these services.
Yesim API (partners-api.yesim.biz)
- Purpose: This is the main service for managing eSIMs. It is used to create user accounts, activate eSIM profiles, and add data plans.
- Data Sent: When you activate an eSIM, the plugin sends necessary information such as email address, ICCID number, payment/order identifier, and selected plan details to this API.
- Service Provider: Yesim LLC.
Izisim API (api.izisim.app)
- Purpose: This service is used to fetch the latest available eSIM data plans for display in the WordPress admin panel.
- Data Sent: The plugin sends your unique API key/token to authenticate and retrieve the plan list.
- Service Provider: Yesim LLC.
QR Code Generation Service (api.qrserver.com)
- Purpose: This service generates QR codes that are included in customer emails for installing an eSIM.
- Data Sent: The plugin sends the LPA code to generate the QR code image.
- Service Provider: GoQR.me
- Links: Terms of Service, Privacy Policy
Theme Integration
- Note: This plugin may add an email handling file to your active theme’s directory to ensure proper integration with your site’s design.
Installation
- Upload the plugin folder to
/wp-content/plugins/yesim-esim-plan-importer/. - Activate the plugin through the “Plugins” menu in WordPress.
- Configure your API settings in the plugin administration panel.
- Use the Sync button to import eSIM plans into WooCommerce.
- Complete a WooCommerce order to trigger customer eSIM delivery email.
FAQ
-
What happens if I change my theme?
-
If you switch themes, the plugin will automatically handle the necessary email integration with the new theme.
-
Is there a shortcode to show grouped products?
-
Yes, use
[yesim_grouped_products]. -
When is the eSIM email sent?
-
The customer email is sent automatically when the WooCommerce order status changes to completed.
-
How does the plugin determine the customer email language?
-
The plugin detects the active website language during WooCommerce checkout, stores it in the order metadata, and uses it to select the correct localized email template. If the language cannot be determined, it falls back to the WordPress site language and finally to English.
-
What happens if the customer language is not supported?
-
The plugin falls back to the WordPress site language. If the site language is also not supported, English is used by default.
-
Which email languages are supported?
-
The MVP supports English, German, Spanish, and Czech.
-
Are dynamic placeholders translated?
-
No. Dynamic values such as ICCID, activation code, QR code, plan data, and order data are preserved and inserted into each localized email template.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Yesim – eSIM Plan Importer (EPI)” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Yesim – eSIM Plan Importer (EPI)” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- Added automatic customer language detection from the multilingual website context
- Added language persistence during WooCommerce checkout
- Added fallback language resolution using WordPress site locale
- Added English fallback for unsupported languages
- Added multilingual email template system
- Added localized customer activation emails
- Added support for English, German, Spanish, and Czech email templates
- Localized email subjects, headings, order summary sections, eSIM details, installation instructions, support messages, and footer messages
- Preserved all dynamic email values across language versions
- Improved international customer experience during eSIM delivery
1.0.10
- Improved customer eSIM activation emails by splitting valid LPA codes into separate manual installation fields
- Added SM-DP+ Address, Activation Code, and Confirmation Code fields to the eSIM Details email section
- Added fallback behavior to display the original LPA Code when the LPA string cannot be parsed
- Updated manual installation instructions to better match iPhone eSIM setup fields
1.0.9
- Added eSIM Passport link support in customer delivery emails
- Added Open eSIM Passport button to the email template when the eSIM Passport URL is available
- Improved email delivery by using the WooCommerce mailer when available
- Added fallback to wp_mail() when the WooCommerce mailer is not available
- Improved email headers by using WooCommerce store email settings for From and Reply-To
- Added email recipient, sender header, and send-result logging to simplify delivery debugging
1.0.8
- Added batch processing for admin sync imports
- Improved import stability for large eSIM plan catalogs
- Reduced repeated processing during synchronization
- Improved grouped and simple WooCommerce product update flow
- Improved imported image handling
- Added import locking/session handling to avoid duplicate sync execution
- Improved AJAX-based admin synchronization flow
- Fixed multiple issues related to sync reliability
- Updated User-Agent to 1.0.8
1.0.4
- Fixed nonce verification for sorting parameters
- Optimized database queries for better performance
- Removed deprecated esim_shortcode_grouped_products() function
- Added proper nonce handling for pagination links
- Fixed all remaining security warnings
1.0.3
- Fixed security issues: nonce verification and input sanitization
- Optimized database queries with caching
- Fixed all remaining warnings from plugin check
- Updated User-Agent to 1.0.3
1.0.2
- Fixed security issues: nonce verification, input sanitization, and escaping
- Replaced date() with gmdate() for better compatibility
- Fixed class and function naming conventions
- Updated Tested up to WordPress version to 6.9
1.0.1
- Security improvements: Added nonce verification and user permission checks
- Code quality: Replaced cURL with WordPress HTTP API
- Data storage: Improved file path handling using WordPress standards
- Documentation: Added external services documentation
- Output security: Implemented proper variable escaping
1.0.0
- Initial release: eSIM import, grouped products, and email delivery.