Merge d22d95c into 856d135

php/class-customize-snapshot.php

@@ -294,10 +294,11 @@ public function save( array $args ) {
 		/**
 		 * Filter the snapshot's data before it's saved to 'post_content'.
 		 *
-		 * @param array $data Customizer snapshot data, with setting IDs mapped to an array
-		 *                    containing a `value` array item and potentially other metadata.
+		 * @param array              $data Customizer snapshot data, with setting IDs mapped to an array
+		 *                                 containing a `value` array item and potentially other metadata.
+		 * @param Customize_Snapshot $this Snapshot object.
 		 */
-		$this->data = apply_filters( 'customize_snapshot_save', $this->data );
+		$this->data = apply_filters( 'customize_snapshot_save', $this->data, $this );
 
 		$result = $this->snapshot_manager->post_type->save( array_merge(
 			$args,

tests/php/test-class-customize-snapshot.php

@@ -323,4 +323,25 @@ function test_saved() {
 			'data' => array( 'foo' => array( 'value' => 'bar' ) ),
 		) );
 	}
+
+	/**
+	 * Test that the snapshot object is passed as the second filter param.
+	 *
+	 * @see Customize_Snapshot::save()
+	 */
+	function test_filter_customize_snapshot_save() {
+		$manager = new Customize_Snapshot_Manager( $this->plugin );
+		$manager->init();
+
+		$snapshot = new Customize_Snapshot( $manager, self::UUID );
+
+		add_filter( 'customize_snapshot_save', function( $data, $test_snapshot ) use ( $snapshot ) {
+			$this->assertEquals( $test_snapshot, $snapshot );
+		}, 10, 2 );
+
+		$snapshot->save( array(
+			'uuid' => self::UUID,
+			'data' => array( 'foo' => array( 'value' => 'bar' ) ),
+		) );
+	}
 }