diff options
| -rwxr-xr-x | include/items.php | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/include/items.php b/include/items.php index 9a3f761a4..f5eccfccd 100755 --- a/include/items.php +++ b/include/items.php @@ -5504,6 +5504,22 @@ function get_iconfig(&$item, $family, $key) { } +/** + * set_iconfig(&$item, $family, $key, $value, $sharing = false); + * + * $item - item array or item id. If passed an array the iconfig meta information is + * added to the item structure (which will need to be saved with item_store eventually). + * If passed an id, the DB is updated, but may not be federated and/or cloned. + * $family - namespace of meta variable + * $key - key of meta variable + * $value - value of meta variable + * $sharing - boolean (default false); if true the meta information is propagated with the item + * to other sites/channels, mostly useful when $item is an array and has not yet been stored/delivered. + * If the meta information is added after delivery and you wish it to be shared, it may be necessary to + * alter the item edited timestamp and invoke the delivery process on the updated item. The edited + * timestamp needs to be altered in order to trigger an item_store_update() at the receiving end. + */ + function set_iconfig(&$item, $family, $key, $value, $sharing = false) { |