Configuration ≫ Options' Stock Manager

See Variant Stock for details and instructions on use.

General: Enable Products Options Stock Manager?

Key: POSM_ENABLE
Path: Configuration > Options' Stock Manager
Description: Enable the Products' Options' Stock processing for the storefront?

General: Duplicate Model Numbers

Key: POSM_DUPLICATE_MODELNUMS
Path: Configuration > Options' Stock Manager
Description: How should the admin-level tools handle duplicate model numbers? Choose one of:
  1. Allow (default): No message, allows saving.
  2. Disallow: Issue message, don't allow saving.
  3. Message-Only: Issue message, allow saving.

General: Divider Color

Key: POSM_DIVIDER_COLOR
Path: Configuration > Options' Stock Manager
Description: Enter the background color to be used for the divider in Catalog :: Products' Options' Stock Manager.

General: Options Stock Re-order Level

Key: POSM_STOCK_REORDER_LEVEL
Path: Configuration > Options' Stock Manager
Description: Enter the low-stock level for products with options' stock. This value is used to highlight low-stock options within the Catalog->Manage Options' Stock tools and, if Configuration->E-mail Options->Send Low Stock Emails is enabled, determines the stock-level at which to send those emails.

Note: The value entered must consist of numeric (0-9) characters only.

General: Back-in-Stock Date Reminder

Key: POSM_BIS_DATE_REMINDER
Path: Configuration > Options' Stock Manager
Description: If your store is using POSM's back-in-stock labels with availability dates, you might want a reminder when a date is imminent. Identify the number of days prior to any expiration that the notification should be issued; set the value to 0 (the default) if you do not want a reminder.

General: Option Types to Manage?

Key: POSM_OPTIONS_TYPES_TO_MANAGE
Path: Configuration > Options' Stock Manager
Description: Enter the types of options to manage using a packed, comma-separated list. Currently, only Dropdown/Select (0) and Radio (2) option types are supported!

General: Optional Option Types List

Key: POSM_OPTIONAL_OPTION_TYPES_LIST
Path: Configuration > Options' Stock Manager
Description: Enter types of options to be ignored when determining if a product's option-combination is managed, using a packed, comma-separated list.

The built-in Zen Cart option types are Dropdown/Select (0), Text (1), Radio (2), Checkbox (3), File (4) and Read-Only (5).

General: Optional Option Names List

Key: POSM_OPTIONAL_OPTION_NAMES_LIST
Path: Configuration > Options' Stock Manager
Description: Enter the list of optional product options for your store, using a packed, comma-separated list of their option_id values. All option values associated with the options that you identify here are ignored when determining if a product's option-combination is managed.

Use this value in conjunction with the "Optional Option Types List" to refine your store's option-combination configurations.

Stock Status Display: Show Messages?

Key: POSM_SHOW_STOCK_MESSAGES
Path: Configuration > Options' Stock Manager
Description: Choose where (Store Only, Admin Only, Both or Neither) the POSM in-/out-of-stock messages will be displayed.

If you choose Store Only or Both, this status will be displayed to your customers on the shopping_cart, checkout_confirmation and account_history_info pages. See also the Dependent Attributes: Stock Status Display setting, below, which operates independently of this setting.

If you choose Admin Only or Both, the in-/out-of-stock messages will be displayed within your Customers->Orders details display, invoices and packing slips.

Stock Status Display: Messages for Unmanaged Options?

Key: POSM_SHOW_UNMANAGED_OPTIONS_STATUS
Path: Configuration > Options' Stock Manager
Description: Should the store-side processing include in-/out-of-stock messages for non-POSM-managed products? If set to true, the messages will be displayed depending on the unmanaged product's stock quantity — In Stock if > 0; the default out-of-stock message (PRODUCTS_OPTIONS_STOCK_NOT_IN_STOCK), otherwise.

Stock Status Display: Include In-Stock Status?

Key: POSM_SHOW_IN_STOCK_MESSAGE
Path: Configuration > Options' Stock Manager
Description: Choose whether to include the display of the "in-stock" product status, wherever that status-display is enabled. If set to false, only out-of-stock messages will be displayed.

Admin: Model Number Field Width

Key: POSM_ADMIN_MODEL_WIDTH
Path: Configuration > Options' Stock Manager
Description: Use this setting to control the width of the Option Model/SKU field displayed by Catalog :: Manage Options' Stock and Catalog :: Options' Stock — View All pages. Enter a valid CSS "width" value, e.g. 9em (default) or 9px.

Note: Leave the setting blank to use the database-defined field width.

Dependent Attributes: Enable

Key: POSM_DEPENDENT_ATTRS_ENABLE
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should be enabled.

Dependent Attributes: Insert "Please Choose"?

Key: POSM_DEPENDENT_ATTRS_PLEASE_CHOOSE
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should insert a "Please Choose" selection into a product's drop-down options. If false, the first option value for each attribute is assumed to be a "Please choose …" type value.

Note: This setting does not apply when a product has a single drop-down option.

Dependent Attributes: Show Model Number?

Key: POSM_DEPENDENT_ATTRS_SHOW_MODEL
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should include the model-numbers for each attribute value on the final, selectable attribute's option.

Note: A model-number is included only if that value is not an empty string.

Dependent Attributes: Show Stock Status?

Key: POSM_DEPENDENT_ATTRS_STOCK_STATUS
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should include the in-/out-of-stock status for each attribute value on the final, selectable attribute's option.

Note: In-stock status is included only if Stock Status Display: Include In-Stock Status? is set to true.

Dependent Attributes: Show In-Stock Quantity in Status?

Key: POSM_DEPENDENT_ATTRS_STOCK_STATUS_QTY
Path: Configuration > Options' Stock Manager
Description: When Dependent Attributes: Stock Status Display and Stock Status Display: Include In-Stock Status? are both true, should the in-stock quantity be displayed when the option-combination is In Stock?

Dependent Attributes: Outer Selector

Key: POSM_ATTRIBUTE_WRAPPER_SELECTOR
Path: Configuration > Options' Stock Manager
Description: Identify the outer CSS selector (default: an empty string) that wraps all elements associated with a single option.

Notes:
  1. For Zen Cart's built-in responsive_classic and template_default templates (and clones thereof), this value should be set to .attribBlock.
  2. For the bootstrap template (and clones thereof), this value should be set to an empty string.

Dependent Attributes: Inner Selector

Key: POSM_ATTRIBUTE_SELECTOR
Path: Configuration > Options' Stock Manager
Description: Identify the inner CSS selector (default: .wrapperAttribsOptions) that contains, at a minimum, each option's name. Note: This value should be changed only if your custom template has modified the attributes' display formatting.

Dependent Attributes: Option Name Selector

Key: POSM_OPTION_NAME_SELECTOR
Path: Configuration > Options' Stock Manager
Description: Identify the CSS selector (default: .optionName) that identifies the element that contains the current option's name. Note: This value should be changed only if your custom template has modified the attributes' display formatting.

Dependent Attributes: Attributes Images Selector

Key: POSM_ATTRIBUTE_IMAGE_SELECTOR
Path: Configuration > Options' Stock Manager
Description: Identify the CSS selector (default: .attribImg) that wraps, if configured, each attribute's image. Note: This value should be changed only if your custom template has modified the attributes' display formatting.

Dependent Attributes: Use Minified Script File?

Key: POSM_USE_MINIFIED_JSCRIPT
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should load the minified version of the jQuery script, reducing the page-load time for a product's page.

View All: Allow Model Number Updates?

Key: POSM_VIEW_ALL_MODEL_UPDATE
Path: Configuration > Options' Stock Manager
Description: Should the "View All" processing for Catalog->Manage Options' Stock enable the managed variants' model numbers to be updated? If set to false, the model numbers are displayed but cannot be updated; you'll need to update the model numbers on a product-by-product basis.

View All: Maximum Products/Page

Key: POSM_MAX_PRODUCTS_VIEW_ALL
Path: Configuration > Options' Stock Manager
Description: Enter the maximum number of products to display on a single page of the View All tool.

Shopping Cart: Display Model Numbers?

Key: POSM_CART_DISPLAY_MODEL_NUMBERS
Path: Configuration > Options' Stock Manager
Description: Should the shopping_cart page display a product's model-number? If you choose true, a product's model number is appended to its name for the display, e.g. "Product Name [model]", if the model-number is not empty.

Enable debug?

Key: POSM_ENABLE_DEBUG
Path: Configuration > Options' Stock Manager
Description: If enabled, the POSM processing will write debug information to either a myDEBUG-POSM-*.log (for store-side actions) or a myDEBUG-POSM-adm-*.log (for admin-side actions) file in your store's logs directory.



Still have questions? Use the Search box in the upper right, or try the full list of FAQs. If you can't find it there, head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified July 13, 2024 by Scott C Wilson (70f5bea).