* Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org) * * Licensed under The MIT License * For full copyright and license information, please see the LICENSE.txt * Redistributions of files must retain the above copyright notice * * @copyright Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org) * @link http://book.cakephp.org/2.0/en/development/testing.html CakePHP(tm) Tests * @since 3.0.0 * @license http://www.opensource.org/licenses/mit-license.php MIT License */ namespace Cake\Test\TestCase\View; use Cake\Cache\Cache; use Cake\Controller\Controller; use Cake\Core\Configure; use Cake\Core\Plugin; use Cake\Event\EventManager; use Cake\TestSuite\TestCase; use Cake\View\Cell; use Cake\View\CellTrait; use TestApp\View\CustomJsonView; /** * CellTest class. * * For testing both View\Cell & Utility\CellTrait */ class CellTest extends TestCase { /** * setUp method * * @return void */ public function setUp() { parent::setUp(); Configure::write('App.namespace', 'TestApp'); Plugin::load(['TestPlugin', 'TestTheme']); $request = $this->getMock('Cake\Network\Request'); $response = $this->getMock('Cake\Network\Response'); $this->View = new \Cake\View\View($request, $response); } /** * tearDown method * * @return void */ public function tearDown() { parent::tearDown(); Plugin::unload('TestPlugin'); Plugin::unload('TestTheme'); unset($this->View); } /** * Tests basic cell rendering. * * @return void */ public function testCellRender() { $cell = $this->View->cell('Articles::teaserList'); $render = "{$cell}"; $this->assertEquals('teaser_list', $cell->template); $this->assertContains('

Lorem ipsum

', $render); $this->assertContains('

Usectetur adipiscing eli

', $render); $this->assertContains('

Topis semper blandit eu non

', $render); $this->assertContains('

Suspendisse gravida neque

', $render); $cell = $this->View->cell('Cello'); $this->assertInstanceOf('TestApp\View\Cell\CelloCell', $cell); $this->assertEquals("Cellos\n", $cell->render()); } /** * Test __toString() hitting an error when rendering views. * * @return void */ public function testCellImplictRenderWithError() { $capture = function ($errno, $msg) { restore_error_handler(); $this->assertEquals(E_USER_WARNING, $errno); $this->assertContains('Could not render cell - Cell view file', $msg); }; set_error_handler($capture); $cell = $this->View->cell('Articles::teaserList'); $cell->template = 'nope'; $result = "{$cell}"; } /** * Tests that we are able pass multiple arguments to cell methods. * * This test sets its own error handler, as PHPUnit won't convert * errors into exceptions when the caller is a __toString() method. * * @return void */ public function testCellWithArguments() { $cell = $this->View->cell('Articles::doEcho', ['msg1' => 'dummy', 'msg2' => ' message']); $render = "{$cell}"; $this->assertContains('dummy message', $render); } /** * Tests that cell runs default action when none is provided. * * @return void */ public function testDefaultCellAction() { $appCell = $this->View->cell('Articles'); $this->assertEquals('display', $appCell->template); $this->assertContains('dummy', "{$appCell}"); $pluginCell = $this->View->cell('TestPlugin.Dummy'); $this->assertContains('dummy', "{$pluginCell}"); $this->assertEquals('display', $pluginCell->template); } /** * Tests manual render() invocation. * * @return void */ public function testCellManualRender() { $cell = $this->View->cell('Articles::doEcho', ['msg1' => 'dummy', 'msg2' => ' message']); $this->assertContains('dummy message', $cell->render()); $cell->teaserList(); $this->assertContains('

Lorem ipsum

', $cell->render('teaser_list')); } /** * Tests manual render() invocation with error * * @expectedException \Cake\View\Exception\MissingCellViewException * @return void */ public function testCellManualRenderError() { $cell = $this->View->cell('Articles'); $cell->render('derp'); } /** * Test rendering a cell with a theme. * * @return void */ public function testCellRenderThemed() { $this->View->theme = 'TestTheme'; $cell = $this->View->cell('Articles', ['msg' => 'hello world!']); $this->assertEquals($this->View->theme, $cell->theme); $this->assertContains('Themed cell content.', $cell->render()); $this->assertEquals($cell->View->theme, $cell->theme); } /** * Test that a cell can render a plugin view. * * @return void */ public function testCellRenderPluginTemplate() { $cell = $this->View->cell('Articles'); $this->assertContains( 'TestPlugin Articles/display', $cell->render('TestPlugin.display') ); $cell = $this->View->cell('Articles'); $cell->plugin = 'TestPlugin'; $this->assertContains( 'TestPlugin Articles/display', $cell->render('display') ); } /** * Tests that using plugin's cells works. * * @return void */ public function testPluginCell() { $cell = $this->View->cell('TestPlugin.Dummy::echoThis', ['msg' => 'hello world!']); $this->assertContains('hello world!', "{$cell}"); } /** * Test that plugin cells can render other view templates. * * @return void */ public function testPluginCellAlternateTemplate() { $cell = $this->View->cell('TestPlugin.Dummy::echoThis', ['msg' => 'hello world!']); $cell->template = '../../Element/translate'; $this->assertContains('This is a translatable string', "{$cell}"); } /** * Test that plugin cells can render other view templates. * * @return void */ public function testPluginCellAlternateTemplateRenderParam() { $cell = $this->View->cell('TestPlugin.Dummy::echoThis', ['msg' => 'hello world!']); $result = $cell->render('../../Element/translate'); $this->assertContains('This is a translatable string', $result); } /** * Tests that using an unexisting cell throws an exception. * * @expectedException \Cake\View\Exception\MissingCellException * @return void */ public function testUnexistingCell() { $cell = $this->View->cell('TestPlugin.Void::echoThis', ['arg1' => 'v1']); $cell = $this->View->cell('Void::echoThis', ['arg1' => 'v1', 'arg2' => 'v2']); } /** * Tests missing method errors * * @expectedException \BadMethodCallException * @expectedExceptionMessage Class TestApp\View\Cell\ArticlesCell does not have a "nope" method. * @return void */ public function testCellMissingMethod() { $this->View->cell('Articles::nope'); } /** * Test that cell options are passed on. * * @return void */ public function testCellOptions() { $cell = $this->View->cell('Articles', [], ['limit' => 10, 'nope' => 'nope']); $this->assertEquals(10, $cell->limit); $this->assertFalse(property_exists('nope', $cell), 'Not a valid option'); } /** * Test that cells get the helper configuration from the view that created them. * * @return void */ public function testCellInheritsHelperConfig() { $this->View->helpers = ['Url', 'Form', 'Banana']; $cell = $this->View->cell('Articles'); $this->assertSame($this->View->helpers, $cell->helpers); } /** * Test that cells the view class name of a custom view passed on. * * @return void */ public function testCellInheritsCustomViewClass() { $request = $this->getMock('Cake\Network\Request'); $response = $this->getMock('Cake\Network\Response'); $view = new CustomJsonView($request, $response); $cell = $view->cell('Articles'); $this->assertSame('TestApp\View\CustomJsonView', $cell->viewClass); } /** * Test cached render. * * @return void */ public function testCachedRenderSimple() { $mock = $this->getMock('Cake\Cache\CacheEngine'); $mock->method('init') ->will($this->returnValue(true)); $mock->method('read') ->will($this->returnValue(false)); $mock->expects($this->once()) ->method('write') ->with('cell_test_app_view_cell_articles_cell_display', "dummy\n"); Cache::config('default', $mock); $cell = $this->View->cell('Articles', [], ['cache' => true]); $result = $cell->render(); $this->assertEquals("dummy\n", $result); Cache::drop('default'); } /** * Test cached render array config * * @return void */ public function testCachedRenderArrayConfig() { $mock = $this->getMock('Cake\Cache\CacheEngine'); $mock->method('init') ->will($this->returnValue(true)); $mock->method('read') ->will($this->returnValue(false)); $mock->expects($this->once()) ->method('write') ->with('my_key', "dummy\n"); Cache::config('cell', $mock); $cell = $this->View->cell('Articles', [], [ 'cache' => ['key' => 'my_key', 'config' => 'cell'] ]); $result = $cell->render(); $this->assertEquals("dummy\n", $result); Cache::drop('cell'); } }