Implements searchRefItems() in list managers

It eases retrieving associated items from other domains and is faster than using searchItems() if the main item is already available
Uses new searchRefItems() in promotion html client
Removes unused method
Adds code example to interface documentation of searchRefItems()
Merge pull request #388 from nsendetzky/master

Implements searchRefItems() in list managers