shopp('cart.download-items')

Loops through only the downloadable items in the cart (ignoring other types of products).

shopp('cart', 'download-items', 'options')

@param string $object the object or object.tag combination, if object.tag is used, the tag parameter can be omitted
@param string $tag the tag, can be hyphenated or not. Prefix with 'get' as shorthand for the return=true option
@param mixed $options associative array, or url-style name=value pairs separated by ampersands (&). Each pair is passed to the theme api tag as an option.
@returns boolean True for each download item in the shopping cart

This tag will return true if there are downloadable items in the shopping cart. It also moves to the next available downloadable item and sets the current cart item context. This allows for looping through the only the downloadable items in the shopping cart and use the Cart Item tags. This is similar to “The Loop” structure in WordPress for displaying a custom layout for WordPress posts, but is specific to downloadable shopping cart items.

Options

Universal Options

All Theme API calls have these options.

  • return: when set to true, 1, or on, this option forces the tag to return the value instead of displaying/echoing the value to the page. Alternatively, prefix the tag parameter with get to get the same effect. All theme api tags that return a boolean value will return by default.
  • echo: when set to false, 0, or off, this option forces the tag to display the value to the page. This is the default for all non-boolean tags.
  • is: when set to true, 1, or on, this option will evaluate the return of the theme api call as a boolean true or false value. See how values are converted to boolean.

Examples

<?php while(shopp('cart','download-items')) {…} ?>

Render a list of downloadable items in the shopping cart

<?php if (shopp('cart','has-items')): // Make sure the cart has items first ?>


<ul>
    <?php while(shopp('cart','download-items')): // Loop through only the downloadable items ?>
    <?php // Show the name and price of the downloadable cart item ?>
    <li><?php shopp('cartitem','name'); ?>, <strong><?php shopp('cartitem','total'); ?></strong></li>
    <?php endwhile; ?>
</ul>


<?php endif; ?>

See Also

You must be logged in to post a comment.

© Ingenesis Limited. Shopp™ is a registered trademark of Ingenesis Limited.

Skip to toolbar