LimitCharacters()} */ public function providerLimitCharacters() { // Plain text values always encoded safely // HTML stored in non-html fields is treated literally. return [ ['The little brown fox jumped over the lazy cow.', 'The little brown fox...'], ['

Short & Sweet

', '<p>Short & Sweet</p>'], ['This text contains & in it', 'This text contains &...'], ]; } /** * Test {@link Text->LimitCharacters()} * * @dataProvider providerLimitCharacters * @param string $originalValue * @param string $expectedValue */ public function testLimitCharacters($originalValue, $expectedValue) { $textObj = DBField::create_field('Text', $originalValue); $result = $textObj->obj('LimitCharacters')->forTemplate(); $this->assertEquals($expectedValue, $result); } /** * @return array */ public function providerLimitCharactersToClosestWord() { return [ // Standard words limited, ellipsis added if truncated ['Lorem ipsum dolor sit amet', 24, 'Lorem ipsum dolor sit...'], // Complete words less than the character limit don't get truncated, ellipsis not added ['Lorem ipsum', 24, 'Lorem ipsum'], ['Lorem', 24, 'Lorem'], ['', 24, ''], // No words produces nothing! // Special characters are encoded safely ['Nice & Easy', 24, 'Nice & Easy'], // HTML stored in non-html fields is treated literally. // If storing HTML you should use DBHTMLText instead ['

Lorem ipsum dolor sit amet

', 24, '<p>Lorem ipsum dolor...'], ['

Lorem ipsum dolor sit amet

', 24, '<p><span>Lorem ipsum...'], ['

Lorem ipsum

', 24, '<p>Lorem ipsum</p>'], ['Lorem & ipsum dolor sit amet', 24, 'Lorem &amp; ipsum dolor...'] ]; } /** * Test {@link Text->LimitCharactersToClosestWord()} * * @dataProvider providerLimitCharactersToClosestWord * * @param string $originalValue Raw string input * @param int $limit * @param string $expectedValue Expected template value */ public function testLimitCharactersToClosestWord($originalValue, $limit, $expectedValue) { $textObj = DBField::create_field('Text', $originalValue); $result = $textObj->obj('LimitCharactersToClosestWord', [$limit])->forTemplate(); $this->assertEquals($expectedValue, $result); } /** * Test {@link Text->LimitWordCount()} */ public function providerLimitWordCount() { return [ // Standard words limited, ellipsis added if truncated ['The little brown fox jumped over the lazy cow.', 3, 'The little brown...'], [' This text has white space around the ends ', 3, 'This text has...'], // Words less than the limt word count don't get truncated, ellipsis not added ['Two words', 3, 'Two words'], // Two words shouldn't have an ellipsis ['These three words', 3, 'These three words'], // Three words shouldn't have an ellipsis ['One', 3, 'One'], // Neither should one word ['', 3, ''], // No words produces nothing! // Text with special characters ['Nice & Easy', 3, 'Nice & Easy'], ['One & Two & Three', 3, 'One & Two...'], // HTML stored in non-html fields is treated literally. // If storing HTML you should use DBHTMLText instead ['

Text inside a paragraph tag should also work

', 3, '<p>Text inside a...'], ['

Two words

', 3, '<p>Two words</p>'], ]; } /** * Test {@link DBText->LimitWordCount()} * * @dataProvider providerLimitWordCount * * @param string $originalValue Raw string input * @param int $limit Number of words * @param string $expectedValue Expected template value */ public function testLimitWordCount($originalValue, $limit, $expectedValue) { $textObj = DBField::create_field('Text', $originalValue); $result = $textObj->obj('LimitWordCount', [$limit])->forTemplate(); $this->assertEquals($expectedValue, $result); } /** */ public function providerLimitSentences() { return [ ['', 2, ''], ['First sentence.', 2, 'First sentence.'], ['First sentence. Second sentence.', 2, 'First sentence. Second sentence.'], // HTML stored in non-html fields is treated literally. // If storing HTML you should use DBHTMLText instead ['

First sentence.

', 2, '<p>First sentence.</p>'], ['

First sentence. Second sentence. Third sentence

', 2, '<p>First sentence. Second sentence.'], ]; } /** * Test {@link DBText->LimitSentences()} * * @dataProvider providerLimitSentences * @param string $originalValue * @param int $limit Number of sentences * @param string $expectedValue Expected template value */ public function testLimitSentences($originalValue, $limit, $expectedValue) { $textObj = DBField::create_field('Text', $originalValue); $result = $textObj->obj('LimitSentences', [$limit])->forTemplate(); $this->assertEquals($expectedValue, $result); } public function providerFirstSentence() { return [ ['', ''], ['First sentence.', 'First sentence.'], ['First sentence. Second sentence', 'First sentence.'], ['First sentence? Second sentence', 'First sentence?'], ['First sentence! Second sentence', 'First sentence!'], // HTML stored in non-html fields is treated literally. // If storing HTML you should use DBHTMLText instead ['
First sentence.', '<br />First sentence.'], ['

First sentence. Second sentence. Third sentence

', '<p>First sentence.'], ]; } /** * @dataProvider providerFirstSentence * @param string $originalValue * @param string $expectedValue */ public function testFirstSentence($originalValue, $expectedValue) { $textObj = DBField::create_field('Text', $originalValue); $result = $textObj->obj('FirstSentence')->forTemplate(); $this->assertEquals($expectedValue, $result); } /** * each test is in the format input, charactere limit, highlight, expected output * * @return array */ public function providerContextSummary() { return [ [ 'This is some text. It is a test', 20, 'test', '... text. It is a test' ], [ // Retains case of original string 'This is some test text. Test test what if you have multiple keywords.', 50, 'some test', 'This is some test text.' . ' Test test what if you have...' ], [ 'Here is some text & HTML included', 20, 'html', '... text & HTML inc...' ], [ 'A dog ate a cat while looking at a Foobar', 100, 'a', // test that it does not highlight too much (eg every a) 'A dog ate a cat while looking at a Foobar', ], [ 'A dog ate a cat while looking at a Foobar', 100, 'ate', // it should highlight 3 letters or more. 'A dog ate a cat while looking at a Foobar', ] ]; } /** * @dataProvider providerContextSummary * @param string $originalValue Input * @param int $limit Numer of characters * @param string $keywords Keywords to highlight * @param string $expectedValue Expected output (XML encoded safely) */ public function testContextSummary($originalValue, $limit, $keywords, $expectedValue) { $text = DBField::create_field('Text', $originalValue); $result = $text->obj('ContextSummary', [$limit, $keywords])->forTemplate(); // it should highlight 3 letters or more. $this->assertEquals($expectedValue, $result); } public function testRAW() { $data = DBField::create_field('Text', 'This & This'); $this->assertEquals($data->RAW(), 'This & This'); } public function testXML() { $data = DBField::create_field('Text', 'This & This'); $this->assertEquals($data->XML(), 'This & This'); } public function testHTML() { $data = DBField::create_field('Text', 'This & This'); $this->assertEquals($data->HTML(), 'This & This'); } public function testJS() { $data = DBField::create_field('Text', '"this is a test"'); $this->assertEquals($data->JS(), '\"this is a test\"'); } public function testATT() { $data = DBField::create_field('Text', '"this is a test"'); $this->assertEquals($data->ATT(), '"this is a test"'); } }