| Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision |
| v:1.0:templates [2012/07/31 20:46] – external edit 127.0.0.1 | v:1.0:templates [2016/05/30 18:36] – [A Quick Start Guide] roman |
|---|
| - Hit the "update template" button at the bottom of the page //after// the page has reloaded and you've received the green success box. If you'd like, you can copy the cached code and review/modify it (though if you have to modify it, it's probably a bug that we'd love to fix if you [[http://www.foxycart.com/bug-report-because-bugs-happen.html|let us know]]). | - Hit the "update template" button at the bottom of the page //after// the page has reloaded and you've received the green success box. If you'd like, you can copy the cached code and review/modify it (though if you have to modify it, it's probably a bug that we'd love to fix if you [[http://www.foxycart.com/bug-report-because-bugs-happen.html|let us know]]). |
| - Test your template. Try something like this to go directly to checkout: ''http://YOURDOMAIN.foxycart.com/cart?name=blah&price=10&cart=checkout'' | - Test your template. Try something like this to go directly to checkout: ''http://YOURDOMAIN.foxycart.com/cart?name=blah&price=10&cart=checkout'' |
| | - Keep the template and its associated files (images and CSS) on the server at the specified URLs. |
| |
| ==== Advanced Customizations for Advanced Fun ==== | ==== Advanced Customizations for Advanced Fun ==== |
| |
| If, however, you do want more control, you don't have to use the ''block'' and ''use'' method, and you can instead just start with the underlying default template and customize from there. These links will show you the Twig templates from which you can start from: | If, however, you do want more control, you don't have to use the ''block'' and ''use'' method, and you can instead just start with the underlying default template and customize from there. These links will show you the Twig templates from which you can start from: |
| * [[https://admin.foxycart.com/v/1.0.0/view/cart_template.twig|Cart]] | * [[https://admin.foxycart.com/v/1.0.0/view/public/cart.inc.twig|Cart]] |
| * [[https://admin.foxycart.com/v/1.0.0/view/cart_template.txt.twig|Cart Text]] for Text Emails | * [[https://admin.foxycart.com/v/1.0.0/view/public/cart.inc.txt.twig|Cart Text]] for Text Emails |
| * [[https://admin.foxycart.com/v/1.0.0/view/checkout_template.twig|Checkout]] | * [[https://admin.foxycart.com/v/1.0.0/view/public/checkout.inc.twig|Checkout]] |
| * [[https://admin.foxycart.com/v/1.0.0/view/checkout_error_template.twig|Checkout Errors]] | * [[https://admin.foxycart.com/v/1.0.0/view/public/checkout_error.inc.twig|Checkout Errors]] |
| * [[https://admin.foxycart.com/v/1.0.0/view/receipt_template.twig|Receipt]] | * [[https://admin.foxycart.com/v/1.0.0/view/public/receipt.inc.twig|Receipt]] |
| * [[https://admin.foxycart.com/v/1.0.0/view/email_order_details.twig|Email (HTML)]] | * [[https://admin.foxycart.com/v/1.0.0/view/public/email_order_details.inc.twig|Email (HTML)]] |
| * [[https://admin.foxycart.com/v/1.0.0/view/email_order_details.txt.twig|Email (Text)]] | * [[https://admin.foxycart.com/v/1.0.0/view/public/email_order_details.inc.txt.twig|Email (Text)]] |
| |
| If you use any of the above linked files as a starting point, you can insert that raw Twig+HTML directly into your FoxyCart template (either directly in the admin or in your own templates for use with AutoMagiCache). | If you use any of the above linked files as a starting point, you can insert that raw Twig+HTML directly into your FoxyCart template (either directly in the admin or in your own templates for use with AutoMagiCache). |
| === Allowed Twig Tags and Functionality === | === Allowed Twig Tags and Functionality === |
| At present, the only allowed functionality for Twig is as follows: | At present, the only allowed functionality for Twig is as follows: |
| * Tags: ''if'', ''for'', ''include'', ''macro'', ''block'' | * Tags: ''if'', ''for'', ''include'', ''macro'', ''block'', ''set'' |
| * Filters: ''escape'', ''raw'', ''length'' | * Filters: ''escape'', ''raw'', ''length'' |
| ===== Default Template Styles ===== | ===== Default Template Styles ===== |
| |
| ==== Important Notes ==== | ==== Important Notes ==== |
| | * **Linked Stylesheets if the ''rel'' attribute is after the ''href'' attribute.** This one is weird, and //shouldn't// be a problem (the regex is perfect), but if you have ''<link>'' elements that aren't being cached, switch the order of the attributes and put the ''rel="stylesheet"'' before the ''href'' attribute. |
| * **Preventing Hotlinking?** If you're running scripts to prevent hotlinking, that may interfere with the template caching. If images aren't showing up properly, turn off your hotlinking protection while you cache your templates. | * **Preventing Hotlinking?** If you're running scripts to prevent hotlinking, that may interfere with the template caching. If images aren't showing up properly, turn off your hotlinking protection while you cache your templates. |
| * **Attributes must be enclosed in single or double quotes** like ''src="foo/bar"'' or ''src='foo/bar'''. | * **Attributes must be enclosed in single or double quotes** like ''src="foo/bar"'' or ''src='foo/bar'''. |
