Merge branch 'release/1.0.5'

* release/1.0.5:
  Changelog for 1.0.5
  More docblock fixing
  Docblock fixing
  Better Property declarations
  Changelog and Readme for product types
  Product Type context now working
  Load the JS on product types

Author: joshangell

CHANGELOG.md

@@ -5,10 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## Unreleased
+
+
+## 1.0.5 - 2018-09-27
+
+### Added
+- Added support for Product Types if Commerce is installed
+
+
 ## 1.0.4 - 2018-09-26
 
 ### Fixed
-- Fixed an error in composer.json where the version string was not matching the tag name.
+- Fixed an error in composer.json where the version string was not matching the tag name
 
 
 ## 1.0.3 - 2018-09-25

README.md

@@ -61,7 +61,7 @@ return [
 
 Targets are alternative templates that you want to make available to Live Preview, you can add them by going to the Portal tab in the main navigation.
 
-If you have multiple Sites then you can load different templates for each Site, as well as restrict a Target to either a Section or Category Group.
+If you have multiple Sites then you can load different templates for each Site, as well as restrict a Target to either a Section, Category Group or Product Type.
 
 Once you have a Target added you will see a select input appear in the Live Preview window allowing your users to efficiently preview their content across multiple templates.
 

src/Portal.php

@@ -19,27 +19,19 @@
 use craft\events\TemplateEvent;
 use craft\helpers\Json;
 use craft\services\Plugins;
-use craft\events\PluginEvent;
 use craft\web\UrlManager;
 use craft\events\RegisterUrlRulesEvent;
 use craft\web\View;
 
+use craft\commerce\Plugin as CommercePlugin;
+
 use yii\base\Event;
 use yii\web\NotFoundHttpException;
 
 /**
- * Craft plugins are very much like little applications in and of themselves. We’ve made
- * it as simple as we can, but the training wheels are off. A little prior knowledge is
- * going to be required to write a plugin.
- *
- * For the purposes of the plugin docs, we’re going to assume that you know PHP and SQL,
- * as well as some semi-advanced concepts like object-oriented programming and PHP namespaces.
- *
- * https://craftcms.com/docs/plugins/introduction
- *
  * @author    Angell & Co
  * @package   Portal
- * @since     0.1.0
+ * @since     1.0.0
  *
  * @property  TargetsService $targets
  * @method    Settings getSettings()
@@ -57,6 +49,14 @@ class Portal extends Plugin
      */
     public static $plugin;
 
+    /**
+     * Set to true if Craft Commerce is installed
+     *
+     * @var bool
+     */
+    public static $commerceInstalled;
+
+
     // Public Properties
     // =========================================================================
 
@@ -67,6 +67,7 @@ class Portal extends Plugin
      */
     public $schemaVersion = '0.1.0';
 
+
     // Public Methods
     // =========================================================================
 
@@ -86,6 +87,9 @@ public function init()
         parent::init();
         self::$plugin = $this;
 
+        // Check if Commerce is installed
+        self::$commerceInstalled = class_exists(CommercePlugin::class);
+
         // Register our CP routes
         Event::on(
             UrlManager::class,
@@ -143,6 +147,7 @@ function(TemplateEvent $event) {
      * Loads up the CP resources we need for Live Preview.
      *
      * @throws NotFoundHttpException
+     * @throws \craft\errors\SiteNotFoundException
      * @throws \yii\base\InvalidConfigException
      */
     private function _loadLivePreviewCpResources()
@@ -157,10 +162,10 @@ private function _loadLivePreviewCpResources()
             $context = false;
 
             // Entries
-            if (count($segments) >= 3 && $segments[ 0 ] == 'entries')
+            if (count($segments) >= 3 && $segments[ 0 ] === 'entries')
             {
 
-                if ($segments[ 2 ] == 'new')
+                if ($segments[ 2 ] === 'new')
                 {
                     $section = Craft::$app->sections->getSectionByHandle($segments[ 1 ]);
                 }
@@ -183,14 +188,23 @@ private function _loadLivePreviewCpResources()
 
             }
             // Category groups
-            else if (count($segments) >= 3 && $segments[ 0 ] == 'categories')
+            else if (count($segments) >= 3 && $segments[ 0 ] === 'categories')
             {
                 $group = Craft::$app->categories->getGroupByHandle($segments[ 1 ]);
                 if ($group)
                 {
                     $context = 'categoryGroup:'.$group->id;
                 }
             }
+            // Product Types
+            else if ($this::$commerceInstalled && count($segments) >= 4 && $segments[ 0 ] === 'commerce' && $segments[ 1 ] === 'products')
+            {
+                $productType = CommercePlugin::getInstance()->productTypes->getProductTypeByHandle($segments[ 2 ]);
+                if ($productType)
+                {
+                    $context = 'productType:'.$productType->id;
+                }
+            }
 
 
             // Then, if we are we can get the data we need and run

src/assetbundles/livepreview/LivePreviewAsset.php

@@ -21,7 +21,7 @@
  *
  * @author    Angell & Co
  * @package   Portal
- * @since     0.1.0
+ * @since     1.0.0
  */
 class LivePreviewAsset extends AssetBundle
 {

src/assetbundles/src/LivePreview.js

@@ -13,7 +13,7 @@
  * @copyright Copyright (c) 2018 Angell & Co
  * @link      https://angell.io
  * @package   Portal
- * @since     0.1.0
+ * @since     1.0.0
  */
 
 if (typeof Portal === 'undefined')

src/controllers/TargetsController.php

@@ -39,7 +39,7 @@
  *
  * @author    Angell & Co
  * @package   Portal
- * @since     0.1.0
+ * @since     1.0.0
  */
 class TargetsController extends Controller
 {

src/errors/TargetNotFoundException.php

@@ -17,7 +17,7 @@
  *
  * @author    Angell & Co
  * @package   Portal
- * @since     0.1.0
+ * @since     1.0.0
  */
 class TargetNotFoundException extends Exception
 {

src/migrations/Install.php

@@ -28,7 +28,7 @@
  *
  * @author    Angell & Co
  * @package   Portal
- * @since     0.1.0
+ * @since     1.0.0
  */
 class Install extends Migration
 {

src/models/Settings.php

@@ -20,7 +20,7 @@
  *
  * @author    Angell & Co
  * @package   Portal
- * @since     0.1.0
+ * @since     1.0.0
  */
 class Settings extends Model
 {

src/models/Target.php

@@ -21,11 +21,14 @@
 /**
  * Target Model
  *
- * @property Target_SiteSettings[] $siteSettings Site-specific settings
+ * @property int|null $id ID
+ * @property string|null $name Name
+ * @property string|null $context Context
+ * @property Target_SiteSettings[] $siteSettings Site settings
  *
  * @author    Angell & Co
  * @package   Portal
- * @since     0.1.0
+ * @since     1.0.0
  */
 class Target extends Model
 {
@@ -52,6 +55,10 @@ class Target extends Model
      */
     public $siteSettings;
 
+
+    // Private Properties
+    // =========================================================================
+
     /**
      * @var array|null Context Options
      */