<?php

[0] Fix | Delete

[1] Fix | Delete

namespace Code_Snippets\Cloud;

[2] Fix | Delete

[3] Fix | Delete

use Code_Snippets\Data_Item;

[4] Fix | Delete

use function Code_Snippets\code_snippets_build_tags_array;

[5] Fix | Delete

[6] Fix | Delete

/**

[7] Fix | Delete

* A snippet object as retrieved from the cloud API.

[8] Fix | Delete

*

[9] Fix | Delete

* @since 3.4.0

[10] Fix | Delete

* @package Code_Snippets

[11] Fix | Delete

*

[12] Fix | Delete

* @property int $id The remote ID.

[13] Fix | Delete

* @property string $name The snippet title.

[14] Fix | Delete

* @property string $description The formatted description.

[15] Fix | Delete

* @property string $code The executable code.

[16] Fix | Delete

* @property array<string> $tags An array of the tags.

[17] Fix | Delete

* @property string $scope The scope name.

[18] Fix | Delete

* @property string $codevault Name of user codevault.

[19] Fix | Delete

* @property string $total_votes The total number of votes.

[20] Fix | Delete

* @property string $vote_count The number of actual votes.

[21] Fix | Delete

* @property string $wp_tested Tested with WP version.

[22] Fix | Delete

* @property string $status Snippet Status ID.

[23] Fix | Delete

* @property string $created The date and time when the snippet data was first created, in ISO format.

[24] Fix | Delete

* @property string $updated When the snippet was last updated, in ISO format.

[25] Fix | Delete

* @property integer $revision The update revision number.

[26] Fix | Delete

* @property bool $is_owner If user is owner or author of snippet.

[27] Fix | Delete

*/

[28] Fix | Delete

class Cloud_Snippet extends Data_Item {

[29] Fix | Delete

[30] Fix | Delete

/**

[31] Fix | Delete

* Constructor function.

[32] Fix | Delete

*

[33] Fix | Delete

* @param array<string, mixed>|null $initial_data Initial snippet data.

[34] Fix | Delete

*/

[35] Fix | Delete

public function __construct( ?array $initial_data = null ) {

[36] Fix | Delete

parent::__construct(

[37] Fix | Delete

[

[38] Fix | Delete

'id' => '',

[39] Fix | Delete

'cloud_id' => '',

[40] Fix | Delete

'name' => '',

[41] Fix | Delete

'description' => '',

[42] Fix | Delete

'code' => '',

[43] Fix | Delete

'tags' => [],

[44] Fix | Delete

'scope' => '',

[45] Fix | Delete

'status' => '',

[46] Fix | Delete

'codevault' => '',

[47] Fix | Delete

'total_votes' => '',

[48] Fix | Delete

'vote_count' => '',

[49] Fix | Delete

'wp_tested' => '',

[50] Fix | Delete

'created' => '',

[51] Fix | Delete

'updated' => '',

[52] Fix | Delete

'revision' => 0,

[53] Fix | Delete

'is_owner' => false,

[54] Fix | Delete

'shared_network' => false,

[55] Fix | Delete

],

[56] Fix | Delete

$initial_data

[57] Fix | Delete

);

[58] Fix | Delete

}

[59] Fix | Delete

[60] Fix | Delete

/**

[61] Fix | Delete

* Prepare a value before it is stored.

[62] Fix | Delete

*

[63] Fix | Delete

* @param mixed $value Value to prepare.

[64] Fix | Delete

* @param string $field Field name.

[65] Fix | Delete

*

[66] Fix | Delete

* @return mixed Value in the correct format.

[67] Fix | Delete

*/

[68] Fix | Delete

protected function prepare_field( $value, string $field ) {

[69] Fix | Delete

switch ( $field ) {

[70] Fix | Delete

case 'id':

[71] Fix | Delete

case 'revision':

[72] Fix | Delete

return absint( $value );

[73] Fix | Delete

[74] Fix | Delete

case 'is_owner':

[75] Fix | Delete

return (bool) $value;

[76] Fix | Delete

case 'description':

[77] Fix | Delete

return ( null === $value ) ? '' : $value;

[78] Fix | Delete

case 'tags':

[79] Fix | Delete

return code_snippets_build_tags_array( $value );

[80] Fix | Delete

[81] Fix | Delete

default:

[82] Fix | Delete

return $value;

[83] Fix | Delete

}

[84] Fix | Delete

}

[85] Fix | Delete

}

[86] Fix | Delete

[87] Fix | Delete