v6.1.5

.github/workflows/github-twittction.yml

@@ -0,0 +1,19 @@
+name: 'Release to Twitter Workflow'
+# Trigger on release
+on:
+  release:
+    types:
+      - published
+jobs:
+  test:
+    name: posting_on_twitter
+    runs-on: ubuntu-latest
+    steps:
+      - name: GitHub Twittction
+        uses: m1ner79/[email protected]
+        with:
+            twitter_status: "[New Release] SharepointPlus ${{github.event.release.tag_name}} – review the changelog at ${{github.event.release.html_url}}"
+            twitter_consumer_key: ${{ secrets.TWITTER_API_KEY }}
+            twitter_consumer_secret: ${{ secrets.TWITTER_API_SECRET_KEY }}
+            twitter_access_token_key: ${{ secrets.TWITTER_ACCESS_TOKEN }}
+            twitter_access_token_secret: ${{ secrets.TWITTER_ACCESS_TOKEN_SECRET }}

.gitignore

@@ -1 +1,2 @@
 node_modules/
+package-lock.json

changelog.md

@@ -1,11 +1,16 @@
 # Changelog
 
+**Change Log v6.1.5 (March 5, 2021)**
+
+  - Fixed `$SP().list().get()` when using `join` option and when there is no data in the left-list
+  - Fixed `$SP().list().setReadOnly()` (see https://github.com/Aymkdn/SharepointPlus/issues/166)
+
 **Change Log v6.1.4 (February 1, 2021)**
 
   - Added `$SP().list().removeAttachment()`
   - Added `$SP().list().getVersions()`
   - Added `$SP().list().restoreVersion()`
-  – Changed `$SP().list().stopWorkflow()` to not use `iframe` and make it work with NodeJS Server Application
+  - Changed `$SP().list().stopWorkflow()` to not use `iframe` and make it work with NodeJS Server Application
   - Fixed a Sharepoint bug: if a list has the versioning enabled, then add/remove an attachment will created an empty version which could reset the values for the "Multiple Lines of Text" fields with "Append" option – `$SP().list().addAttachment()` and `$SP().list().removeAttachment()` will restore the previous version to avoid this buggy behavior
   - Fixed `$SP().list().get()` with option `json:true` to return an object for each item instead of an array of keys
   - Fixed `$SP().list().getWorkflowID()` when there are more than 1 workflow for an item (see https://github.com/Aymkdn/SharepointPlus/issues/162)

dist/lists/add.js

@@ -68,8 +68,10 @@ var _getTimeZoneInfo = _interopRequireDefault(require("../utils/getTimeZoneInfo.
   @return {Promise} resolve({passed, failed}), reject(error)
 
   @example
+  // to add 1 item
   $SP().list("My List").add({Title:"Ok"});
 
+  // to add several items
   $SP().list("List Name").add([{Title:"Ok"}, {Title:"Good"}]).then(function(items) { alert("Done!"); });
 
   $SP().list("My List","http://my.sharepoi.nt/dir/").add({Title:"Ok"}).then(function(items) {

dist/lists/get.js

@@ -1076,7 +1076,7 @@ function _get() {
 
                       joinLookupField = false; // if we join it with another list
 
-                      if (!setup.join) {
+                      if (!(setup.join && aReturn.length > 0)) {
                         _context14.next = 159;
                         break;
                       }

dist/lists/update.js

@@ -64,10 +64,13 @@ var _getContentTypeInfo = _interopRequireDefault(require("./getContentTypeInfo.j
   @return {Promise} resolve({passed, failed}), reject(error)
 
   @example
+  // to update 1 item
   $SP().list("My List").update({ID:1, Title:"Ok"});
+
   // if you use the WHERE then you must not provide the item ID:
   $SP().list("List Name").update({Title:"Ok"},{where:"Status = 'Complete'"});
 
+  // to update several items with a known ID
   $SP().list("My List","http://sharepoint.org/mydir/").update([{ID:5, Title:"Ok"}, {ID: 15, Title:"Good"}]);
 
   $SP().list("List Name").update({ID:43, Title:"Ok"}).then(function(items) {

dist/main.js

@@ -76,7 +76,7 @@ function () {
   (0, _createClass2.default)(SharepointPlus, [{
     key: "getVersion",
     value: function getVersion() {
-      return "6.1.2";
+      return "6.1.5";
     }
     /**
       @name $SP().auth
@@ -179,6 +179,7 @@ function () {
               case "remove":
               case "removeAttachment":
               case "restoreVersion":
+              case "setReadOnly":
               case "startWorkflow":
               case "startWorkflow2013":
               case "stopWorkflow":

docs/core.html

@@ -94,7 +94,7 @@ <h3>Returns:</h3>
   <div>Documentation built by <a target="_blank" href="http://twitter.com/aymkdn">@aymkdn</a> (<a href="http://kodono.info">http://kodono.info</a>) with <a href="https://jsdoc.app/">JSDoc</a>.</div>
   <div>This work is licensed under <a rel="license" href="https://github.com/Aymkdn/SharepointPlus/blob/master/license.md">LGPL-3</a>.</div>
   <div>Designed with <a href="http://twitter.github.com/bootstrap/">Bootstrap from Twitter</a>.</div>
-  <div>Automatically generated with JSDoc on Mon, 01 Feb 2021 16:55:20 GMT</div>
+  <div>Automatically generated with JSDoc on Fri, 05 Mar 2021 13:23:39 GMT</div>
 </footer>
 <script>prettyPrint()</script>
 </body>

docs/files.html

@@ -298,7 +298,7 @@ <h3>Example:</h3>
   <div>Documentation built by <a target="_blank" href="http://twitter.com/aymkdn">@aymkdn</a> (<a href="http://kodono.info">http://kodono.info</a>) with <a href="https://jsdoc.app/">JSDoc</a>.</div>
   <div>This work is licensed under <a rel="license" href="https://github.com/Aymkdn/SharepointPlus/blob/master/license.md">LGPL-3</a>.</div>
   <div>Designed with <a href="http://twitter.github.com/bootstrap/">Bootstrap from Twitter</a>.</div>
-  <div>Automatically generated with JSDoc on Mon, 01 Feb 2021 16:55:19 GMT</div>
+  <div>Automatically generated with JSDoc on Fri, 05 Mar 2021 13:23:39 GMT</div>
 </footer>
 <script>prettyPrint()</script>
 </body>

docs/index.html

@@ -59,7 +59,7 @@
 
 
       <div class="span10" id="main"> <!-- content -->
-        <h1>SharepointPlus 6.1.4</h1>
+        <h1>SharepointPlus 6.1.5</h1>
         <div class="alert alert-danger alert-bordered">Important changes introduced with <b>SharepointPlus v6.0</b>. Make sure to <a href="https://github.com/Aymkdn/SharepointPlus/wiki/SharepointPlus-v6.0-Announcement">read the announcement</a> and to read the <a href="https://github.com/Aymkdn/SharepointPlus/blob/master/changelog.md">changelog</a>.</div>
         <div>
           <a href="https://twitter.com/sp_js" class="twitter-follow-button" data-show-count="false" data-lang="en" data-dnt="true">Follow @sp_js</a>
@@ -381,7 +381,7 @@ <h2>Older Versions</h2>
   <div>Documentation built by <a target="_blank" href="http://twitter.com/aymkdn">@aymkdn</a> (<a href="http://kodono.info">http://kodono.info</a>) with <a href="https://jsdoc.app/">JSDoc</a>.</div>
   <div>This work is licensed under <a rel="license" href="https://github.com/Aymkdn/SharepointPlus/blob/master/license.md">LGPL-3</a>.</div>
   <div>Designed with <a href="http://twitter.github.com/bootstrap/">Bootstrap from Twitter</a>.</div>
-  <div>Automatically generated with JSDoc on Mon, 01 Feb 2021 16:55:19 GMT</div>
+  <div>Automatically generated with JSDoc on Fri, 05 Mar 2021 13:23:39 GMT</div>
 </footer>
 <script>prettyPrint()</script>
 </body>

docs/lists.html

@@ -100,8 +100,10 @@ <h3>Returns:</h3>
 
           <h3>Example:</h3>
 
-          <pre class="prettyprint lang-js">$SP().list("My List").add({Title:"Ok"});
+          <pre class="prettyprint lang-js">// to add 1 item
+  $SP().list("My List").add({Title:"Ok"});
 
+  // to add several items
   $SP().list("List Name").add([{Title:"Ok"}, {Title:"Good"}]).then(function(items) { alert("Done!"); });
 
   $SP().list("My List","http://my.sharepoi.nt/dir/").add({Title:"Ok"}).then(function(items) {
@@ -1665,10 +1667,13 @@ <h3>Returns:</h3>
 
           <h3>Example:</h3>
 
-          <pre class="prettyprint lang-js">$SP().list("My List").update({ID:1, Title:"Ok"});
+          <pre class="prettyprint lang-js">// to update 1 item
+  $SP().list("My List").update({ID:1, Title:"Ok"});
+
   // if you use the WHERE then you must not provide the item ID:
   $SP().list("List Name").update({Title:"Ok"},{where:"Status = 'Complete'"});
 
+  // to update several items with a known ID
   $SP().list("My List","http://sharepoint.org/mydir/").update([{ID:5, Title:"Ok"}, {ID: 15, Title:"Good"}]);
 
   $SP().list("List Name").update({ID:43, Title:"Ok"}).then(function(items) {
@@ -1796,7 +1801,7 @@ <h3>Example:</h3>
   <div>Documentation built by <a target="_blank" href="http://twitter.com/aymkdn">@aymkdn</a> (<a href="http://kodono.info">http://kodono.info</a>) with <a href="https://jsdoc.app/">JSDoc</a>.</div>
   <div>This work is licensed under <a rel="license" href="https://github.com/Aymkdn/SharepointPlus/blob/master/license.md">LGPL-3</a>.</div>
   <div>Designed with <a href="http://twitter.github.com/bootstrap/">Bootstrap from Twitter</a>.</div>
-  <div>Automatically generated with JSDoc on Mon, 01 Feb 2021 16:55:20 GMT</div>
+  <div>Automatically generated with JSDoc on Fri, 05 Mar 2021 13:23:39 GMT</div>
 </footer>
 <script>prettyPrint()</script>
 </body>

docs/modals.html

@@ -380,7 +380,7 @@ <h3>Parameters:</h3>
   <div>Documentation built by <a target="_blank" href="http://twitter.com/aymkdn">@aymkdn</a> (<a href="http://kodono.info">http://kodono.info</a>) with <a href="https://jsdoc.app/">JSDoc</a>.</div>
   <div>This work is licensed under <a rel="license" href="https://github.com/Aymkdn/SharepointPlus/blob/master/license.md">LGPL-3</a>.</div>
   <div>Designed with <a href="http://twitter.github.com/bootstrap/">Bootstrap from Twitter</a>.</div>
-  <div>Automatically generated with JSDoc on Mon, 01 Feb 2021 16:55:20 GMT</div>
+  <div>Automatically generated with JSDoc on Fri, 05 Mar 2021 13:23:39 GMT</div>
 </footer>
 <script>prettyPrint()</script>
 </body>

docs/node.html

@@ -169,7 +169,7 @@ <h3>Example:</h3>
   <div>Documentation built by <a target="_blank" href="http://twitter.com/aymkdn">@aymkdn</a> (<a href="http://kodono.info">http://kodono.info</a>) with <a href="https://jsdoc.app/">JSDoc</a>.</div>
   <div>This work is licensed under <a rel="license" href="https://github.com/Aymkdn/SharepointPlus/blob/master/license.md">LGPL-3</a>.</div>
   <div>Designed with <a href="http://twitter.github.com/bootstrap/">Bootstrap from Twitter</a>.</div>
-  <div>Automatically generated with JSDoc on Mon, 01 Feb 2021 16:55:19 GMT</div>
+  <div>Automatically generated with JSDoc on Fri, 05 Mar 2021 13:23:39 GMT</div>
 </footer>
 <script>prettyPrint()</script>
 </body>

docs/people.html

@@ -470,7 +470,7 @@ <h3>Example:</h3>
   <div>Documentation built by <a target="_blank" href="http://twitter.com/aymkdn">@aymkdn</a> (<a href="http://kodono.info">http://kodono.info</a>) with <a href="https://jsdoc.app/">JSDoc</a>.</div>
   <div>This work is licensed under <a rel="license" href="https://github.com/Aymkdn/SharepointPlus/blob/master/license.md">LGPL-3</a>.</div>
   <div>Designed with <a href="http://twitter.github.com/bootstrap/">Bootstrap from Twitter</a>.</div>
-  <div>Automatically generated with JSDoc on Mon, 01 Feb 2021 16:55:19 GMT</div>
+  <div>Automatically generated with JSDoc on Fri, 05 Mar 2021 13:23:39 GMT</div>
 </footer>
 <script>prettyPrint()</script>
 </body>

docs/utils.html

@@ -886,7 +886,7 @@ <h3>Example:</h3>
   <div>Documentation built by <a target="_blank" href="http://twitter.com/aymkdn">@aymkdn</a> (<a href="http://kodono.info">http://kodono.info</a>) with <a href="https://jsdoc.app/">JSDoc</a>.</div>
   <div>This work is licensed under <a rel="license" href="https://github.com/Aymkdn/SharepointPlus/blob/master/license.md">LGPL-3</a>.</div>
   <div>Designed with <a href="http://twitter.github.com/bootstrap/">Bootstrap from Twitter</a>.</div>
-  <div>Automatically generated with JSDoc on Mon, 01 Feb 2021 16:55:19 GMT</div>
+  <div>Automatically generated with JSDoc on Fri, 05 Mar 2021 13:23:39 GMT</div>
 </footer>
 <script>prettyPrint()</script>
 </body>

es5/lists/add.js

@@ -41,8 +41,10 @@ import getTimeZoneInfo from '../utils/getTimeZoneInfo.js';
   @return {Promise} resolve({passed, failed}), reject(error)
 
   @example
+  // to add 1 item
   $SP().list("My List").add({Title:"Ok"});
 
+  // to add several items
   $SP().list("List Name").add([{Title:"Ok"}, {Title:"Good"}]).then(function(items) { alert("Done!"); });
 
   $SP().list("My List","http://my.sharepoi.nt/dir/").add({Title:"Ok"}).then(function(items) {

es5/lists/get.js

@@ -1045,7 +1045,7 @@ function _get() {
 
                       joinLookupField = false; // if we join it with another list
 
-                      if (!setup.join) {
+                      if (!(setup.join && aReturn.length > 0)) {
                         _context14.next = 159;
                         break;
                       }

es5/lists/update.js

@@ -33,10 +33,13 @@ import getContentTypeInfo from './getContentTypeInfo.js';
   @return {Promise} resolve({passed, failed}), reject(error)
 
   @example
+  // to update 1 item
   $SP().list("My List").update({ID:1, Title:"Ok"});
+
   // if you use the WHERE then you must not provide the item ID:
   $SP().list("List Name").update({Title:"Ok"},{where:"Status = 'Complete'"});
 
+  // to update several items with a known ID
   $SP().list("My List","http://sharepoint.org/mydir/").update([{ID:5, Title:"Ok"}, {ID: 15, Title:"Good"}]);
 
   $SP().list("List Name").update({ID:43, Title:"Ok"}).then(function(items) {

es5/main.js

@@ -60,7 +60,7 @@ function () {
   _createClass(SharepointPlus, [{
     key: "getVersion",
     value: function getVersion() {
-      return "6.1.2";
+      return "6.1.5";
     }
     /**
       @name $SP().auth
@@ -163,6 +163,7 @@ function () {
               case "remove":
               case "removeAttachment":
               case "restoreVersion":
+              case "setReadOnly":
               case "startWorkflow":
               case "startWorkflow2013":
               case "stopWorkflow":