'. t('Views Or allows Views to combine filters with OR and fields with COALESCE.') .'

'."\n". '

'. t('Combining filters or arguments with OR') .'

'."\n". '

'. t('By default, each record in a view must match all filters. Sometimes records need to be included if they match one or more filters in a list of alternatives. Views has the ability to combine filters only with AND. If one filter is false, the combined list will be false. Views Or adds the ability to combine blocks of filters with OR. If one of the filters in the block is true, the combined block will be true.') .'

'."\n". '

'. t('Views Or provides three filters:') ."\n". '

'. t('Begin alternatives') .': '. t('Begins a block of alternative filters.') .'
'. t('Next alternative') .': '. t('Separates alternative filters in an alternatives block.') .'
'. t('End alternatives') .': '. t('Ends a block of alternative filters.') .'

'."\n". t('Insert these filters between other filters to create alternatives. For example, the following sequence of filters') ."\n". '

'. t('Views Or') .': '. t('Begin alternatives') .' =
'. t('Taxonomy') .': '. t('Term ID') .' = '. t('Carrot') .'
'. t('Views Or') .': '. t('Next alternative') .' =
'. t('Taxonomy: Term ID') .' = '. t('Elephant') .'
'. t('Views Or') .': '. t('End alternatives') .' =

'."\n". t('is equivalent to the following logical expression:') ."\n". '

'."\n".
      '('. t('Taxonomy') .': '. t('Term ID') .' = '. t('Carrot') .') OR ('. t('Taxonomy: Term ID') .' = '. t('Elephant') .')'."\n".
      '

'."\n". '

'. t('Here is a more advanced example. The following sequence of filters') ."\n". '

'. t('Node') .': '. t('Published') .' '. t('True') .'
'. t('Views Or') .': '. t('Begin alternatives') .' =
'. t('Taxonomy') .': '. t('Term ID') .' = '. t('Carrot') .'
'. t('Node') .': '. t('Type') .' = '. t('Forum topic') .'
'. t('Views Or') .': '. t('Next alternative') .' =
'. t('Taxonomy') .': '. t('Term ID') .' = '. t('Elephant') .'
'. t('Node') .': '. t('Type') .' = '. t('Story') .'
'. t('Views Or') .': '. t('End alternatives') .' =
'. t('Node') .': '. t('Post date') .' >= '. t('-3 weeks') .'

'."\n". t('is equivalent to the following logical expression:') ."\n". '

'."\n".
      '('. t('Node') .': '. t('Published') .' '. t('True') .') AND ('."\n".
      '  ('. t('Taxonomy') .': '. t('Term ID') .' = '. t('Carrot') .' AND '. t('Node') .': '. t('Type') .' = '. t('Forum topic') .')'."\n".
      '  OR'."\n".
      '  ('. t('Taxonomy') .': '. t('Term ID') .' = '. t('Elephant') .' AND '. t('Node') .': '. t('Type') .' = '. t('Story') .')'."\n".
      ') AND ('. t('Node') .': '. t('Post date') .' >= '. t('-3 weeks') .')'."\n".
      '

'."\n". '

'. t('Arguments can be combined in the same way as filters. By default, when arguments are combined, the same arguments will be used for both sets of alternatives. So if there are two alternative arguments in a block, the view needs to receive only one argument. Uncheck "Share arguments" in the "Views Or: Next alternative" argument to allow each set of alternatives receive different arguments from the URL') .'

'."\n". '

'. t('Combining fields with COALESCE') .'

'."\n". '

'. t('When using relationships in a view, the same field may appear multiple times. Views Or adds the ability to combine multiple fields into one using the COALESCE function. The value of the combined field will be taken from the first field which contains a value.') .'

'."\n". '

'. t('Views Or provides two fields:') ."\n". '

'. t('Begin alternatives') .': '. t('Begins a group of alternative fields.') .'
'. t('End alternatives') .': '. t('Ends a group of alternative fields.') .'

'."\n". t('Insert other fields between these fields to create a combined field. The title and settings of the first field in the group will be used for the combined field, even if another field contains the value.') .'

'."\n"; } } /** * Implementation of hook_views_api(). */ function views_or_views_api() { return array('api' => 2.0); }