Documentation

# BBIS Wrapper deployment

# Body template

  • From the root directory, start Lando with command lando start
  • View $landoDomain/pages/bbis-wrapper.php in the editor where $landoDomain is replaced by the domain Lando renders
  • Comment out the inclusion of the _head.php.
  • Copy and paste the resluted content into the Template body:
    • Go to Site Explorer > Pages & Templates
    • Click on Templates
    • Click on Edit icon next to the tempalte that starts with DNL - Support Center
    • Click on Edit layouts & CSS > Desktop browsers > DNL - Support Center
    • Click on View tab
    • Click on Code
    • Paste in the code rendered by bbis-wrapper.php

# Head Section

  • Uncomment the inclusion of _head.php from the bbis-wrapper.php
  • Update the head section of the wrapper with content that appears between <head> & </head> tags.
    • In BBIS, in the template editting screen Click Return to go back to the template screens and then select Templates.
    • In the second table under DNL _Support Center there is Page content tab.
    • Click Edit next to DNL: Support Center Head Content
    • Paste the code rendered by bbis-wrapper.php between <head> & </head> tags here.
    • Click Save

# CSS

Since we include head section this seems as a duplicate. However, it's is used to generate secure payment templates, so it's necessary to be included.

  • Compile CSS for production
  • Do a search & replace on all asset paths
    • Search for ../
    • Replace with https://dx2eq2oh924g4.cloudfront.net
  • Paste the new CSS into the layout (Note: It will be used on the payment page)
    • In the template edit screen go to Edit layouts & CSS > Desktop browsers > *DNL - Support Center (layout)
    • Paste in the complied CSS with the replaced assets paths here.

# Images in CSS

The images that reference SVG tags will be stripped out for payment templates. The workaround solution is to use background: in CSS instead of background-image and set the same SVG image as a background image on the element. See .charity__link--bbb in _charity.scss for an example.

# Test

  • Preview that the pages are rendering properly.
    • [https://bbis.savechildren.org/public-pages/dnl-vanity-redirect-homepage](DNL Vanity Redirect Homepage)
    • [https://bbis.savechildren.org/test-page](Test Page)

# Template Updates

  • Once they do, you have to generate a new Payment Page Tempalte
    • Go to Administration > Sites & settings > Schedules tab
    • Locate section Secure payment template update
    • Click on Update templates button, it will generate new payment page templates.

← Main JavaScript file structure →