~~NOTOC~~
====== Handling Private Information Inside Of A Public Block ======

==== Problem ====
Private holes can only be punched at the block level. If a piece of private information does not have its own block, a hole cannot be punched.

==== Solution ===
Add a block for the private information in order to inject the ESI process. 

For example, a user review input form is integrated into a product page by a customized theme. The form can be varied according to each product, and the default nickname is varied by each logged in user. You cannot simply configure the whole page/block to be private. You will need to create a new private block inside of the review form block.

As of version 1.0.2, sample code has been added to demonstrate how to handle private information inside of a public block. There are a few steps to be followed:

    - In the corresponding layout file, add a block. For example: ''customized_theme/layout/catalog.xml'' \\ \\ old:<code>
<block as="review_form" name="product.review.form" template="review/form.phtml" type="review/form"/>
</code> \\ new:<code>
<block as="review_form" name="product.review.form" template="review/form.phtml" type="review/form">
	<block type="litemage/inject_nickname" name="nickname" as="nickname"/>
</block>
</code> \\ **Note:** The sample code is shipped by default under ''Litemage/Block/Inject/Nickname.php''.
    - Modify the template to use the newly injected block for the value. \\ \\ old:  <code><input type="text" name="nickname" id="nickname_field" class="input-text required-entry" value="<?php echo $this->htmlEscape($data->getNickname()) ?>" required/></code> new: <code><input type="text" name="nickname" id="nickname_field" class="input-text required-entry" value="<?php echo $this->getChildHtml('nickname') ?>" required/></code>
  - Since this is inside the value quote, you must add ''$v'' after the block name or block type in LiteMage's ''config.xml'' to avoid extra info/debug info from being output to browser. 

==== Note ====
As always, if you have any customizations, please make these changes in your local directory or create a backup as they will otherwise be overridden by future LiteMage updates.