@sesamy/sesamy-components 2.26.0 → 2.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -345,8 +345,10 @@ The paywall also emits the `addToCart` interaction through sesamy-js when the us
345
345
 
346
346
  **Slots:**
347
347
 
348
+ - `headline`: Replaces the headline from the paywall settings (e.g., placement-specific copy)
348
349
  - `below-headline`: Content rendered below the paywall headline (e.g., additional info, custom elements)
349
350
  - `features`: Content rendered in the features section of the paywall (e.g., feature list, benefits)
351
+ - `login-button-text`: Replaces the text of the "already subscribing" login button
350
352
 
351
353
  **Basic Usage Example:**
352
354
 
@@ -369,7 +371,19 @@ The paywall also emits the `addToCart` interaction through sesamy-js when the us
369
371
 
370
372
  #### Slots
371
373
 
372
- The `sesamy-paywall` component provides three slots for customization:
374
+ The `sesamy-paywall` component provides four slots for customization:
375
+
376
+ ##### headline
377
+
378
+ - **Purpose:** Replaces the headline configured in the paywall settings.
379
+ - **Behavior:** When you provide content in the `headline` slot, it is rendered in place of the stored headline, with the headline's own styling (size, weight, max width). When you leave it empty, the headline from the paywall settings is shown. Use this to vary the copy per placement (e.g., article vs. front page) while reusing one paywall configuration.
380
+ - **Availability:** All templates (`ARTICLE`, `BOXES`, `LOGIN`).
381
+ - **Example:**
382
+ ```html
383
+ <sesamy-paywall settings-url="https://api.example.com/paywall/settings">
384
+ <span slot="headline">Read the full investigation</span>
385
+ </sesamy-paywall>
386
+ ```
373
387
 
374
388
  ##### below-headline
375
389
 
@@ -385,7 +399,8 @@ The `sesamy-paywall` component provides three slots for customization:
385
399
  ##### features
386
400
 
387
401
  - **Purpose:** Replaces the default features section of the paywall.
388
- - **Behavior:** When you provide content in the `features` slot, it will completely replace the built-in features list or section. Use this slot to fully customize the list of benefits, features, or selling points shown to the user.
402
+ - **Behavior:** When you provide content in the `features` slot, it will completely replace the built-in features list or section. Use this slot to fully customize the list of benefits, features, or selling points shown to the user. Slotted content is static: it does not switch when the visitor selects a different subscription option the way the built-in list does.
403
+ - **Availability:** Only the `ARTICLE` template renders a paywall-wide features list. The `BOXES` template shows features inside each box, so the slot has no effect there.
389
404
  - **Example:**
390
405
  ```html
391
406
  <sesamy-paywall settings-url="https://api.example.com/paywall/settings">
@@ -414,7 +429,7 @@ The `sesamy-paywall` component provides three slots for customization:
414
429
 
415
430
  **Note:**
416
431
 
417
- - The `below-headline` slot adds to the paywall, while the `features` and `login-button-text` slots replace the default content entirely.
432
+ - The `below-headline` slot adds to the paywall, while the `headline`, `features` and `login-button-text` slots replace the default content entirely.
418
433
 
419
434
  ### sesamy-visibility
420
435