feat: document BYOS and multi-action button chaining#8
Merged
Conversation
Add the missing coverage for two SDK concepts that were never referenced in the plugin: - Bring Your Own Screen (BYOS): new concept reference with iOS (UIKit + SwiftUI) and Android (View + Fragment) delegates/providers, executeConnection contract, standalone usage, synchronize() requirement, and the anti-patterns BYOS replaces (custom VC over Purchasely, Purchasely.close() then push, skipping display()). iOS + Android only, SDK >= 5.6.0. - Multi-action button chaining: new section in paywall-actions.md explaining how a Composer button can carry several actions (purchase + open_screen / open_placement / deeplink / close, login + purchase), the default when no second action is set (close in Full, stay open in Observer), how the interceptor sees each action separately, and that proceed(false) short-circuits the chain. Cross-linked from concepts/README, sdk-expert agent (new response rule), integrate skill (Step 9), review skill (new section 3.12 BYOS + anti- pattern checkpoint in 3.3). CHANGELOG updated under [Unreleased]. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds the missing coverage for two SDK concepts that were never referenced anywhere in the plugin:
references/concepts/byos.md) covering when to use it (native login step in a Flow, A/B vs. existing paywall, reordering onboarding), Console config (Screen ID + connections), iOS implementation (PLYCustomScreenViewControllerDelegate+ SwiftUIPLYCustomScreenViewDelegate), Android implementation (PLYCustomScreenProvider+PLYCustomScreen.View/.Fragment), theexecuteConnection(...)/execute(connection)handover contract (Flow + standalone),Purchasely.synchronize()requirement for in-screen purchases, analytics behaviour (PRESENTATION_DISPLAYEDonly, in-screen interactions instrumented by the app), and the anti-patterns BYOS replaces (custom VC over Purchasely,Purchasely.close()then push, skippingdisplay()). iOS + Android only, SDK ≥ 5.6.0.paywall-actions.mddocumenting how a Composer button can carry several actions (purchase + open_screen/+ open_placement/+ deeplink/+ close,login + purchase, …), the default when no second action is configured (close in Full mode, stay open in Observer mode), the fact that the interceptor sees each action separately, and thatproceed(false)short-circuits the chain.Cross-linked from:
concepts/README.mdindex + "When to load" tablesdk-expertagent (new response rule #13, dedicated BYOS routing + SDK 5.6 / platform gating)integrateskill (Step 9 — Beyond the Basics)reviewskill (new section 3.12 BYOS with 8 checkpoints, plus a new anti-pattern checkpoint in 3.3 flagging interceptors that try to override the post-purchase flow instead of using a second Composer action)CHANGELOG.mdunder[Unreleased]Test plan
/purchasely:question"Comment afficher un écran de login dans un Flow ?" → must loadbyos.mdand recommend BYOS over presenting a custom VC over the Purchasely controller/purchasely:question"Que se passe-t-il après un purchase si je n'ai pas configuré de 2e action ?" → must cite the Full vs. Observer default/purchasely:integratewalkthrough surfaces BYOS + chained actions in Step 9 for relevant projects/purchasely:reviewon a project withsetCustomScreenProvidertriggers the new 3.12 checklist; on a project without BYOS, the section is skippedpaywall-actions.md↔byos.md,concepts/README.mdindex,sdk-expert.mdref list)🤖 Generated with Claude Code