# Tokens replaced at deploy time
CONNECTION_STRING: {{CONNECTION_STRING}}   # Database connection string
HOST_NAME:          {{HOST_NAME}}            # Public hostname for the site

public class MyScheduledTask : TaskBase
{
    protected override string? Cron => "* * * * *"; // every minute

    public override async Task ExecuteAsync(IPipelineContext context)
    {
        // Task implementation
    }
}

// In plugin's RegisterServices method
builder.Services.AddScheduledTask<MyScheduledTask>();

// Enqueue work onto the background task queue
scheduler.AddAsyncBackgroundTask(async ctx =>
{
    // Use ctx (IPipelineContext), NOT the outer request context
    await ctx.RunPipeline<SomeWorkPipeline>();
});

public class OrderConfirmationNotification : NotificationBase
{
    public override string Name => "OrderConfirmation";

    public Guid OrderId { get; set; }

    public override async Task PopulateReplacementsAsync(
        IPipelineContext context,
        CancellationToken token)
    {
        var order = await context.GetById<Order>(OrderId, token);

        Replacements["orderNumber"] = order.OrderNumber;
        Replacements["customerName"] = order.CustomerName;
        Replacements["totalAmount"] = order.Total.ToString("C");
        Replacements["order"] = order; // nested object for template access
    }
}

// Create and queue the notification
var notification = new OrderConfirmationNotification
{
    OrderId = order.Id,
    To = order.CustomerEmail
};

await notification.QueueAsync(context, token);

# Pattern: {Topic}.{Method}.{Section}.html (case-sensitive)

OrderConfirmation.Email.body.html      # Email body template
OrderConfirmation.Email.subject.html   # Email subject line
OrderConfirmation.Email.from.html      # Sender address
OrderConfirmation.Email.to.html        # Recipient address

public class MyPluginSettings : ISettings
{
    // Key: "MyPluginSettings:EnableFeatureX"
    public bool EnableFeatureX { get; set; } = true;

    // Key: "MyPluginSettings:MaxRetryCount"
    public int MaxRetryCount { get; set; } = 3;

    // Key: "MyPluginSettings:ApiEndpoint"
    public string ApiEndpoint { get; set; } = "";
}

// Resolve settings from the pipeline context
var settings = context.GetSettings<MyPluginSettings>();

if (settings.EnableFeatureX)
{
    // Feature-gated logic
}

public class MyPxConfigHook : IHook<BuildPxConfigPipeline>
{
    public async Task ExecuteAsync(BuildPxConfigPipeline pipeline,
        IPipelineContext context, CancellationToken token)
    {
        var settings = context.GetSettings<MyPluginSettings>();

        pipeline.Config.Add(new PxConfigSection("myPlugin")
        {
            ["enableFeatureX"] = settings.EnableFeatureX,
            ["maxRetryCount"] = settings.MaxRetryCount,
        });
    }
}

public class NetSuiteConnectorSettings : IConnectorSettings
{
    public string ConnectorId => "netsuite";

    public string AccountId { get; set; }
    public string ConsumerKey { get; set; }
    public string ConsumerSecret { get; set; }
    public string TokenId { get; set; }
    public string TokenSecret { get; set; }
}