create initial version

README.md

@@ -67,6 +67,23 @@ Every time you update your model, a new version containing the previous attribut
 
 All timestamps and the optional soft-delete timestamp will be ignored.
 
+<a name="existing" />
+
+### Adding versions to existing data
+
+Versionable creates a version on update() of the *updated* model.  So, if you're installing this on an already existing application, you may want to create a version of the current model:
+
+```php
+    $model->createInitialVersion();
+```
+If no version exists, this will create the initial version.
+
+If you want to do this for all instances of a model:
+
+```php
+    Model::initializeVersionOnAllRows();
+```
+
 <a name="exclude" />
 
 ### Exclude attributes from versioning

src/Mpociot/Versionable/VersionableTrait.php

@@ -189,6 +189,48 @@ protected function versionablePostSave()
         }
     }
 
+
+    /**
+     * Initialize a version on every instance of a model
+     * @return void
+     */
+    public static function initializeVersionOnAllRows()
+    {
+        foreach (self::all() as $obj) {
+            $obj->createInitialVersion();
+        }
+    }
+
+    /**
+     * Save a new version.
+     * @return void
+     */
+    public function createInitialVersion()
+    {
+        if( true === $this->fresh()->versions->isEmpty() &&
+            true === $this->versioningEnabled 
+        ) {
+
+            $class                     = $this->getVersionClass();
+            $version                   = new $class();
+            $version->versionable_id   = $this->getKey();
+            $version->versionable_type = method_exists($this, 'getMorphClass') ? $this->getMorphClass() : get_class($this);
+            $version->user_id          = $this->getAuthUserId();
+
+            $versionedHiddenFields = $this->versionedHiddenFields ?? [];
+            $this->makeVisible($versionedHiddenFields);
+            $version->model_data       = serialize($this->attributesToArray());
+            $this->makeHidden($versionedHiddenFields);
+
+            if (!empty( $this->reason )) {
+                $version->reason = $this->reason;
+            }
+
+            $version->save();
+        }
+    }
+
+
     /**
      * Delete old versions of this model when they reach a specific count.
      * 
@@ -215,6 +257,7 @@ private function purgeOldVersions()
 
     /**
      * Determine if a new version should be created for this model.
+     * Checks if appropriate fields have been changed.
      *
      * @return bool
      */

tests/VersionableTest.php

@@ -529,6 +529,48 @@ public function testWhereModelHasMorphMap()
         $this->assertEquals( $user->attributesToArray(), $version->getModel()->attributesToArray() );
         Relation::morphMap([], false);
     }
+
+    public function testAddVersionableToExistingUser()
+    {
+        $user = new \Illuminate\Foundation\Auth\User();
+        $user->name = "Danny";
+        $user->email = "[email protected]";
+        $user->password = "12345";
+        $user->save();
+
+        $this->assertNull($user->versions );
+
+        $user = TestVersionableUser::find($user->id);
+        $this->assertCount(0, $user->versions );
+        $user->createInitialVersion();
+        $this->assertCount(1, $user->fresh()->versions );
+
+        //ASSERT THAT createInitialVersion() ONLY WORKS ONCE
+        $user->createInitialVersion();
+        $this->assertCount(1, $user->fresh()->versions );
+    }
+
+    public function testInitializeModel()
+    {
+        $user = new \Illuminate\Foundation\Auth\User();
+        $user->name = "Danny";
+        $user->email = "[email protected]";
+        $user->password = "12345";
+        $user->save();
+
+        $this->assertNull($user->versions );
+
+        $user = TestVersionableUser::find($user->id);
+        $this->assertCount(0, $user->versions );
+
+        TestVersionableUser::initializeVersionOnAllRows();
+        $this->assertCount(1, $user->fresh()->versions );
+
+        //ASSERT THAT createInitialVersion() ONLY WORKS ONCE
+        TestVersionableUser::initializeVersionOnAllRows();
+        $this->assertCount(1, $user->fresh()->versions );
+    }
+
 
 }