Publish content fallback implementation

- Entry
      - Added support for function 'includeFallback'
- Query
      - Added support for function 'includeFallback'

Author: uttamukkoji

CHANGELOG.md

@@ -2,6 +2,16 @@
 ## CHANGELOG
 ------------------------------------------------
 
+## Version 1.7.0
+###### Date: 
+### New Feature
+    - Entry
+      - Added support for function 'includeFallback'
+    - Query 
+      - Added support for function 'includeFallback'
+
+------------------------------------------------
+
 ## Version 1.6.1
 ###### Date: 08-May-2020
 ### Bug

src/lib/models/base_query.php

@@ -292,6 +292,21 @@ public function exists($field_uid = '')
         return $this->queryObject;
     }
 
+    /** 
+     * To include fallback content if specified locale content is not publish.
+     * 
+     * @return Query
+    */
+    public function includeFallback() 
+    {
+        $this->queryObject->_query = call_user_func(
+            'contentstackAddBoolean', 
+            'include_fallback', 
+            $this->queryObject->_query
+        );
+        
+        return $this->queryObject;
+    }
     /**
      * To include schema along with entries
      * 

test/AssetsTest.php

@@ -93,6 +93,24 @@ public function testAssetsFindCount() {
         $this->assertTrue(($_assets[0]) === $assets_count);
     }
 
+    public function testIncludeFallback() {
+        $testArray = array("a"=>"en-us", "b" => "hi-in");
+        $_assets = self::$Stack->Assets()->Query()->toJSON()->language("hi-in")->includeFallback()->find();
+        $this->assertEquals(count($_assets[0]), 3);
+        for($i = 0; $i < count($_assets[0]); $i++) {
+            $this->assertContains($_assets[0][$i]["publish_details"]["locale"], $testArray);
+        }
+    }
+
+    public function testWithoutIncludeFallback() {
+        $_assets = self::$Stack->Assets()->Query()->toJSON()->language("hi-in")->find();
+        $this->assertArrayHasKey(0, $_assets);
+        $this->assertEquals(count($_assets[0]), 1);
+        for($i = 0; $i < count($_assets[0]); $i++) {
+            $this->assertEquals($_assets[0][$i]["publish_details"]["locale"], "hi-in");
+        }
+    }
+
     public function testAssetsFindIncludeCount() {
         $_assets = self::$Stack->Assets()->Query()->toJSON()->includeCount()->find();
         $assets = self::$Stack->Assets()->Query()->toJSON()->find();

test/EntriesTest.php

@@ -112,6 +112,25 @@ public function testFindIncludeCount() {
         $this->assertTrue(($_entries[1] === ENTRY_COUNT));
     }
 
+    public function testIncludeFallback() {
+        $testArray = array("a"=>"en-us", "b" => "hi-in");
+        $_entries = self::$Stack->ContentType(CT_ContentType)->Query()->toJSON()->language("hi-in")->includeFallback()->find();
+        $this->assertArrayHasKey(0, $_entries);
+        $this->assertEquals(count($_entries[0]), ENTRY_COUNT);
+        for($i = 0; $i < count($_entries[0]); $i++) {
+            $this->assertContains($_entries[0][$i]["publish_details"]["locale"], $testArray);
+        }
+    }
+
+    public function testWithoutIncludeFallback() {
+        $_entries = self::$Stack->ContentType(CT_ContentType)->Query()->toJSON()->language("hi-in")->find();
+        $this->assertArrayHasKey(0, $_entries);
+        $this->assertEquals(count($_entries[0]), 1);
+        for($i = 0; $i < count($_entries[0]); $i++) {
+            $this->assertEquals($_entries[0][$i]["publish_details"]["locale"], "hi-in");
+        }
+    }
+
     public function testFindIncludeSchema() {
         $_entries = self::$Stack->ContentType(CT_ContentType)->Query()->toJSON()->includeSchema()->find();
         $this->assertArrayHasKey(0, $_entries);