Skip to content
Open source core .NET 4.5 and SQL Server Sannois, France
MAGELIAWebStore
Resources · integration

Connect Orchard in a controlled sequence

Install on a test site, connect one catalog, place one widget and verify one order path before expanding.

Prerequisites

Before the module

ItemCheck
Orchard siteA working test site with a backup and a rollback plan.
WebStore instanceServices reachable, store and catalog configured, test product available.
Module packageThe version that matches the Orchard release and the WebStore services.
PermissionsAn account that can install modules and configure widgets.
NetworkOutbound access from Orchard to the service endpoint over the intended protocol.
Sequence

Install and verify

  1. 01Back up the Orchard site and database.Test the restore before changing anything.
  2. 02Install the module package.Record the version and the source.
  3. 03Configure the service connection.Keep credentials outside content and source control.
  4. 04Place one catalog widget.Verify the products and prices against the console.
  5. 05Test the basket.Confirm that the shopper can add an item and return to the Orchard page.
  6. 06Test an order.Check the order in WebStore and the confirmation in Orchard.
  7. 07Document the versions.Orchard, module, WebStore services and client.
Troubleshooting

Three common failures

Widget is empty

Check the store and catalog assignment, the service endpoint and the product status.

Basket does not persist

Check the session or cookie configuration across the Orchard and service hosts.

Order missing

Read the service response and the application log. A validation message in the basket may be stopping the save.

Primary sources

Orchard reference shelf

Standards, documentation and tools that are relevant to this topic. They open on the publisher's site.

  • Orchard The content management system supported by the integration module.
  • .NET platform Runtime, tooling and framework documentation from Microsoft.
  • OData The open data protocol used by the WebStore services layer.
  • NuGet Package distribution used by the .NET client and samples.
  • Microsoft Learn Reference material for the Microsoft development stack.
  • SQL Server Database engine documentation and editions.
  • OWASP Application security guidance and cheat sheets.
  • W3C Web standards for markup, accessibility and internationalization.
  • web.dev Performance, accessibility and Core Web Vitals guidance.
  • GitHub Source hosting and issue tracking for .NET projects.
Next step

Test the boundary, not only the page

Most integration problems sit between the two systems. Verify the service response and the order record as well as the rendered page.