=== ItsEd Connect Shipping for Early Bird ===
Contributors: itsed
Tags: woocommerce, shipping, delivery, parcel lockers, tracking
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 8.2
Requires Plugins: woocommerce
Stable tag: 3.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Offer Early Bird delivery in WooCommerce with parcel lockers, booking, labels and tracking. Requires a paid ItsEd Connect service account.

== Description ==

Offer Early Bird shipping to customers in covered areas of Sweden, then manage bookings, labels and shipment tracking from WooCommerce.

ItsEd Connect Shipping connects your store to the paid ItsEd Connect service and your Early Bird carrier account. The plugin download is free; live shipping features require an active service entitlement and suitable Early Bird credentials. Check the [service options](https://itsed.se/produkt/earlybird-woocommerce-plugin/) before installing.

= From checkout to shipment =

* Offer home delivery and customer-selected parcel lockers where your carrier agreement and address coverage allow them.
* Check delivery availability for the customer's address before offering a shipping method.
* Configure delivery services and checkout prices for your WooCommerce shipping zones.
* Use guided setup to connect your account, add sender details and review shipping readiness.
* Book shipments automatically according to your booking settings, or manage booking from the order screen.
* Download shipping labels and view tracking information alongside your WooCommerce orders.
* Follow shipment progress in the shipments dashboard and resolve failed bookings from Needs Attention.
* Create eligible return shipments and cancel bookings while the carrier still permits cancellation.
* Include tracking information in WooCommerce emails and the customer's order view.

The plugin supports classic and block checkout, as well as WooCommerce High-Performance Order Storage (HPOS).

= Languages =

The plugin has English source text and is fully internationalized, so its WordPress interface, checkout components and email text can be translated into any locale. Translations are contributed and delivered through translate.wordpress.org; WordPress installs them through the standard translation update system. WordPress chooses the interface language; WooCommerce controls the locale used for customer emails. There is no separate plugin language picker.

Carrier responses and service-generated messages may use their original language. Interface language does not extend the carrier's delivery coverage.

= Before you connect =

You need:

* WordPress 6.6 or newer, PHP 8.2 or newer, and WooCommerce 8.0 or newer.
* A paid ItsEd Connect service entitlement and its activation key.
* An Early Bird agreement, directly or through your logistics partner, with suitable API credentials and enabled services.
* Accurate sender details and product shipping weights and dimensions.
* HTTPS connectivity from your store to ItsEd Connect, and a store endpoint that the service can reach for shipment updates.

Parcel locker delivery requires both the recipient's phone number and email address. Shipping availability depends on the address, parcel and services enabled for your account. This plugin does not promise delivery to every Swedish address or international shipping.

= Help and documentation =

Read the [merchant documentation](https://itsed.se/dokumentation/earlybird-woocommerce/) for setup, shipping configuration, checkout, order management and troubleshooting.

For subscription/account help, contact info@itsed.se, the address used by the plugin's licence-help link. Do not post activation keys, API credentials, order details or customer information in public support requests.

ItsEd provides this integration. It is not affiliated with, endorsed by, or sponsored by Early Bird or WooCommerce. "Early Bird" and "WooCommerce" are used only to describe the services this plugin connects to, and are the trademarks of their respective owners.

== External services ==

This plugin is a client for ItsEd Connect. The hosted service performs carrier API communication, shipment booking, label retrieval, shipment status checks and delivery of status updates back to your store. These operations require communication with external services.

= ItsEd Connect =

Service: https://eb-gateway.itsed.se
Service information and paid plans: https://itsed.se/produkt/earlybird-woocommerce-plugin/
Terms of service: https://eb-edge.itsed.se/terms/woocommerce
Privacy policy: https://eb-edge.itsed.se/privacy

Data is sent for these purposes:

* Account setup and activation: the activation key, a stable installation identifier, store name, carrier credentials, selected carrier environment, sender profile, and the store's webhook and integration health URLs are sent when verifying or connecting the account. Carrier credentials are held by the service; WordPress stores the resulting service API key and webhook secret.
* Checkout coverage: destination postal code and relevant address and parcel details are sent when checking available delivery services, dates and parcel lockers.
* Shipment and return handling: sender and recipient contact/address details, order references, parcel details and selected delivery options are sent when creating or updating the requested shipment operation. Phone and email are included where required for delivery.
* Status and labels: booking, delivery and tracking identifiers are used to request labels, cancellations, returns and shipment status. The service sends shipment updates to the store's webhook endpoint.
* Setup assistance: contextual tips run locally, with a preference stored in the current browser session. Email reminders are a separate optional choice, off until an administrator explicitly enables them for the displayed recipient. WordPress may then send up to two setup reminders through the store's email system. Readiness checks may query an existing ItsEd Connect connection. Enabling local tips does not enroll anyone in email or contact ItsEd support. Earlier automatically enabled reminders remain off until a new explicit email choice is recorded.
* Integration health: the service uses the configured store endpoints and plugin environment/version information to identify connection and compatibility problems.
* Error diagnostics: when remote error reporting is enabled, the plugin sends minimized diagnostic events such as error codes, request identifiers, plugin-relative error locations, and WordPress, WooCommerce, PHP and plugin versions. Reports are associated with the connected store account. Optional diagnostics default off and require an explicit choice in advanced settings. Earlier saved opt-ins without a current consent record are disabled and their buffered reports are discarded; re-enabling applies to future events. These reports are not anonymous.

Connecting the service is necessary for carrier operations. Optional error reporting is separate from the customer and shipment data required to provide those operations.

= Early Bird =

Carrier information: https://earlybird.se
Production carrier API: https://api.earlybird.se
Test carrier API: https://stage.earlybird.se
Carrier terms: The merchant's delivery agreement with Early Bird or its fulfilment partner applies.
Carrier privacy policy: https://earlybird.se/om-early-bird/datapolicy/

ItsEd Connect communicates with Early Bird on your store's behalf using your carrier account. It sends the delivery and parcel information needed for coverage, bookings, labels, returns and tracking. Your selected environment determines whether carrier operations use the production or test service. Production bookings are live shipment requests.

= SureCart =

Billing and entitlement provider: https://surecart.com
Service API: https://api.surecart.com
Provider terms: https://surecart.com/terms-and-conditions/
Provider privacy policy: https://surecart.com/privacy-policy/

ItsEd Connect uses SureCart to validate activation keys and manage service entitlements and store activations. This communication is performed by the service. You do not need to install the SureCart plugin on the shipping store to use this integration. Purchasing or managing a service subscription is separate from the shipment information sent to the carrier.

== Installation ==

1. Install and activate WooCommerce, then install and activate ItsEd Connect Shipping for Early Bird.
2. Open the plugin's guided setup from the Early Bird Shipping menu in WordPress.
3. Follow the account guidance for your situation: an existing carrier agreement, a logistics partner, or a new Early Bird customer.
4. Enter your ItsEd Connect activation key, connect your carrier credentials and select the appropriate test or production environment.
5. Review the sender profile, then add Early Bird Shipping to the intended WooCommerce shipping zones and configure delivery services and prices.
6. For parcel lockers, ensure checkout collects a phone number and email address. Verify the locker selector and available rates with a covered address.
7. Review the booking settings and setup status. Test checkout and the shipment workflow using the appropriate carrier test credentials before creating production bookings.

Read the [setup guide](https://itsed.se/dokumentation/earlybird-woocommerce/setup/) for account connection and the [shipping configuration guide](https://itsed.se/dokumentation/earlybird-woocommerce/fraktkonfiguration/) for shipping zones and services.

== Frequently Asked Questions ==

= Is the plugin free? =

The WordPress plugin is free to download. Its shipping operations use the paid ItsEd Connect service, so an active service entitlement is required. You also need a suitable Early Bird carrier agreement. Installing the plugin does not purchase the service or establish a carrier agreement.

= Do I need an Early Bird account before installing? =

You can install the plugin and use its setup guidance first. To create live shipments, you need the service entitlement and carrier credentials for your agreement. If you ship through a logistics partner, follow the partner path in setup to obtain the correct credentials.

= Can I use it outside Sweden? =

The interface supports English and Swedish, but this integration is intended for Early Bird delivery in covered areas of Sweden. Availability depends on your carrier account, enabled service, parcel and recipient address. Do not assume cross-border shipping or nationwide address coverage from the interface language.

= Does it work with WooCommerce Checkout Blocks and HPOS? =

Yes. The plugin includes integrations for Checkout Blocks and classic checkout, and declares HPOS compatibility. Test your complete checkout with your theme and other checkout extensions before enabling live shipping.

= Why is Early Bird missing from checkout? =

Check that the account is connected, the relevant shipping zone includes the method, and the delivery service is enabled. Also check the recipient address and product shipping details. When the coverage service cannot confirm availability, the plugin does not offer that shipping method. Use the setup status and Needs Attention screen to investigate connection or configuration problems.

= Can I test without creating live shipments? =

The connection supports Early Bird's test environment when you have suitable test credentials. Select that environment during setup. The production environment creates live shipment requests; it is not a preview mode.

= What happens if I disconnect or delete the plugin? =

Disconnecting removes the local connection, and the store can no longer use the service for new shipping operations through the plugin. Deleting the plugin removes its connection credentials and runtime settings. Shipment-related order metadata and the non-secret stable store identifier are intentionally preserved to retain order history and support reconnection.

Removing the plugin does not automatically erase service-side shipment records or cancel a paid service agreement. Use the service's account and privacy procedures for those requests.

= Can I modify the plugin? =

This plugin is licensed under GPLv2 or later. This license applies to the distributed plugin code. Access to the separately operated ItsEd Connect service remains subject to its service agreement and active entitlement.

== Screenshots ==

1. Guided setup explains the paid ItsEd Connect service and separate carrier credentials.
2. Enter a service key or follow the subscription guidance before connecting Early Bird.

== Source code and build tools ==

The directory package includes the readable PHP source under src/, JavaScript and stylesheet source under src-js/, the translation template under languages/, and the package manifests and webpack configuration used to build the browser assets.

JavaScript build: from the plugin directory, run npm ci followed by npm run build. Translation tooling is defined in package.json and scripts/plugin-i18n.mjs; it also uses the development dependencies in composer.json. Run composer install before npm run i18n:extract when regenerating translation source catalogs.

See BUILD.md for the complete build instructions and THIRD-PARTY-NOTICES.md and ASSET-LICENSES.json for bundled dependency and artwork licences.

The separately hosted ItsEd Connect service is not part of the plugin package. Its source is not needed to inspect or rebuild the distributed plugin.

== Changelog ==

= 3.1.1 =

* Setup reminder emails are now off unless a site turns them on with the itsed_connect_earlybird_setup_reminder_emails_enabled filter, so no reminder is sent by default.
* Setup help and reminder preferences are now a single control instead of two overlapping ones.
* Simplified the status cards and the guided setup wording.

= 3.1.0 =

* First WordPress.org release of the ItsEd Connect WooCommerce connector.
* Renamed to "ItsEd Connect Shipping for Early Bird" to make clear that this is a third-party integration.
* Plain-text shipment emails and admin notices reviewed for escaping and scope.
* Translations now come from translate.wordpress.org instead of being bundled.
* GPLv2-or-later plugin source and build instructions included.
* WordPress.org provides plugin updates independently of the paid service subscription.
* Guided setup explains the service key and separate carrier credentials in English and Swedish.
* Optional diagnostic reporting and setup emails require recorded consent; local tips remain separate.

== Upgrade Notice ==

= 3.1.1 =

Setup reminder emails are now off by default and only send when a site enables them with a filter. Existing reminder settings are kept but stay inactive until then.

= 3.1.0 =

Moves plugin updates to WordPress.org and requires a fresh choice for earlier automatic setup emails and optional diagnostics. If you installed an earlier build from outside WordPress.org, install this version from the directory and remove the old copy; your connection and order history are kept.
