| @@ 19-109 (lines=91) @@ | ||
| 16 | * |
|
| 17 | * @author Addshore |
|
| 18 | */ |
|
| 19 | class AliasGroupSetter { |
|
| 20 | ||
| 21 | /** |
|
| 22 | * @var WikibaseApi |
|
| 23 | */ |
|
| 24 | private $api; |
|
| 25 | ||
| 26 | /** |
|
| 27 | * @param WikibaseApi $api |
|
| 28 | */ |
|
| 29 | public function __construct( WikibaseApi $api ) { |
|
| 30 | $this->api = $api; |
|
| 31 | } |
|
| 32 | ||
| 33 | /** |
|
| 34 | * @since 0.2 |
|
| 35 | * |
|
| 36 | * @param AliasGroup $aliasGroup |
|
| 37 | * @param EntityId|Item|Property|SiteLink $target |
|
| 38 | * @param EditInfo|null $editInfo |
|
| 39 | * |
|
| 40 | * @return bool |
|
| 41 | */ |
|
| 42 | public function set( AliasGroup $aliasGroup, $target, EditInfo $editInfo = null ) { |
|
| 43 | $this->throwExceptionsOnBadTarget( $target ); |
|
| 44 | ||
| 45 | $params = $this->getTargetParamsFromTarget( |
|
| 46 | $this->getEntityIdentifierFromTarget( $target ) |
|
| 47 | ); |
|
| 48 | ||
| 49 | $params['language'] = $aliasGroup->getLanguageCode(); |
|
| 50 | $params['set'] = implode( '|', $aliasGroup->getAliases() ); |
|
| 51 | ||
| 52 | $this->api->postRequest( 'wbsetaliases', $params, $editInfo ); |
|
| 53 | return true; |
|
| 54 | } |
|
| 55 | ||
| 56 | /** |
|
| 57 | * @param mixed $target |
|
| 58 | * |
|
| 59 | * @throws UnexpectedValueException |
|
| 60 | * |
|
| 61 | * @todo Fix duplicated code |
|
| 62 | */ |
|
| 63 | private function throwExceptionsOnBadTarget( $target ) { |
|
| 64 | if ( !$target instanceof EntityId && !$target instanceof Item && !$target instanceof Property && !$target instanceof SiteLink ) { |
|
| 65 | throw new UnexpectedValueException( '$target needs to be an EntityId, Item, Property or SiteLink' ); |
|
| 66 | } |
|
| 67 | if ( ( $target instanceof Item || $target instanceof Property ) && $target->getId() === null ) { |
|
| 68 | throw new UnexpectedValueException( '$target Entity object needs to have an Id set' ); |
|
| 69 | } |
|
| 70 | } |
|
| 71 | ||
| 72 | /** |
|
| 73 | * @param EntityId|Item|Property $target |
|
| 74 | * |
|
| 75 | * @throws UnexpectedValueException |
|
| 76 | * @return EntityId|SiteLink |
|
| 77 | * |
|
| 78 | * @todo Fix duplicated code |
|
| 79 | */ |
|
| 80 | private function getEntityIdentifierFromTarget( $target ) { |
|
| 81 | if ( $target instanceof Item || $target instanceof Property ) { |
|
| 82 | return $target->getId(); |
|
| 83 | } else { |
|
| 84 | return $target; |
|
| 85 | } |
|
| 86 | } |
|
| 87 | ||
| 88 | /** |
|
| 89 | * @param EntityId|SiteLink $target |
|
| 90 | * |
|
| 91 | * @throws UnexpectedValueException |
|
| 92 | * @return array |
|
| 93 | * |
|
| 94 | * @todo Fix duplicated code |
|
| 95 | */ |
|
| 96 | private function getTargetParamsFromTarget( $target ) { |
|
| 97 | if ( $target instanceof EntityId ) { |
|
| 98 | return [ 'id' => $target->getSerialization() ]; |
|
| 99 | } elseif ( $target instanceof SiteLink ) { |
|
| 100 | return [ |
|
| 101 | 'site' => $target->getSiteId(), |
|
| 102 | 'title' => $target->getPageName(), |
|
| 103 | ]; |
|
| 104 | } else { |
|
| 105 | throw new UnexpectedValueException( '$target needs to be an EntityId or SiteLink' ); |
|
| 106 | } |
|
| 107 | } |
|
| 108 | ||
| 109 | } |
|
| 110 | ||
| @@ 19-109 (lines=91) @@ | ||
| 16 | * |
|
| 17 | * @author Addshore |
|
| 18 | */ |
|
| 19 | class DescriptionSetter { |
|
| 20 | ||
| 21 | /** |
|
| 22 | * @var WikibaseApi |
|
| 23 | */ |
|
| 24 | private $api; |
|
| 25 | ||
| 26 | /** |
|
| 27 | * @param WikibaseApi $api |
|
| 28 | */ |
|
| 29 | public function __construct( WikibaseApi $api ) { |
|
| 30 | $this->api = $api; |
|
| 31 | } |
|
| 32 | ||
| 33 | /** |
|
| 34 | * @since 0.2 |
|
| 35 | * |
|
| 36 | * @param Term $description |
|
| 37 | * @param EntityId|Item|Property|SiteLink $target |
|
| 38 | * @param EditInfo|null $editInfo |
|
| 39 | * |
|
| 40 | * @return bool |
|
| 41 | */ |
|
| 42 | public function set( Term $description, $target, EditInfo $editInfo = null ) { |
|
| 43 | $this->throwExceptionsOnBadTarget( $target ); |
|
| 44 | ||
| 45 | $params = $this->getTargetParamsFromTarget( |
|
| 46 | $this->getEntityIdentifierFromTarget( $target ) |
|
| 47 | ); |
|
| 48 | ||
| 49 | $params['language'] = $description->getLanguageCode(); |
|
| 50 | $params['value'] = $description->getText(); |
|
| 51 | ||
| 52 | $this->api->postRequest( 'wbsetdescription', $params, $editInfo ); |
|
| 53 | return true; |
|
| 54 | } |
|
| 55 | ||
| 56 | /** |
|
| 57 | * @param mixed $target |
|
| 58 | * |
|
| 59 | * @throws UnexpectedValueException |
|
| 60 | * |
|
| 61 | * @todo Fix duplicated code |
|
| 62 | */ |
|
| 63 | private function throwExceptionsOnBadTarget( $target ) { |
|
| 64 | if ( !$target instanceof EntityId && !$target instanceof Item && !$target instanceof Property && !$target instanceof SiteLink ) { |
|
| 65 | throw new UnexpectedValueException( '$target needs to be an EntityId, Item, Property or SiteLink' ); |
|
| 66 | } |
|
| 67 | if ( ( $target instanceof Item || $target instanceof Property ) && $target->getId() === null ) { |
|
| 68 | throw new UnexpectedValueException( '$target Entity object needs to have an Id set' ); |
|
| 69 | } |
|
| 70 | } |
|
| 71 | ||
| 72 | /** |
|
| 73 | * @param EntityId|Item|Property $target |
|
| 74 | * |
|
| 75 | * @throws UnexpectedValueException |
|
| 76 | * @return EntityId|SiteLink |
|
| 77 | * |
|
| 78 | * @todo Fix duplicated code |
|
| 79 | */ |
|
| 80 | private function getEntityIdentifierFromTarget( $target ) { |
|
| 81 | if ( $target instanceof Item || $target instanceof Property ) { |
|
| 82 | return $target->getId(); |
|
| 83 | } else { |
|
| 84 | return $target; |
|
| 85 | } |
|
| 86 | } |
|
| 87 | ||
| 88 | /** |
|
| 89 | * @param EntityId|SiteLink $target |
|
| 90 | * |
|
| 91 | * @throws UnexpectedValueException |
|
| 92 | * @return array |
|
| 93 | * |
|
| 94 | * @todo Fix duplicated code |
|
| 95 | */ |
|
| 96 | private function getTargetParamsFromTarget( $target ) { |
|
| 97 | if ( $target instanceof EntityId ) { |
|
| 98 | return [ 'id' => $target->getSerialization() ]; |
|
| 99 | } elseif ( $target instanceof SiteLink ) { |
|
| 100 | return [ |
|
| 101 | 'site' => $target->getSiteId(), |
|
| 102 | 'title' => $target->getPageName(), |
|
| 103 | ]; |
|
| 104 | } else { |
|
| 105 | throw new UnexpectedValueException( '$target needs to be an EntityId or SiteLink' ); |
|
| 106 | } |
|
| 107 | } |
|
| 108 | ||
| 109 | } |
|
| 110 | ||
| @@ 19-109 (lines=91) @@ | ||
| 16 | * |
|
| 17 | * @author Addshore |
|
| 18 | */ |
|
| 19 | class LabelSetter { |
|
| 20 | ||
| 21 | /** |
|
| 22 | * @var WikibaseApi |
|
| 23 | */ |
|
| 24 | private $api; |
|
| 25 | ||
| 26 | /** |
|
| 27 | * @param WikibaseApi $api |
|
| 28 | */ |
|
| 29 | public function __construct( WikibaseApi $api ) { |
|
| 30 | $this->api = $api; |
|
| 31 | } |
|
| 32 | ||
| 33 | /** |
|
| 34 | * @since 0.2 |
|
| 35 | * |
|
| 36 | * @param Term $label |
|
| 37 | * @param EntityId|Item|Property|SiteLink $target |
|
| 38 | * @param EditInfo|null $editInfo |
|
| 39 | * |
|
| 40 | * @return bool |
|
| 41 | */ |
|
| 42 | public function set( Term $label, $target, EditInfo $editInfo = null ) { |
|
| 43 | $this->throwExceptionsOnBadTarget( $target ); |
|
| 44 | ||
| 45 | $params = $this->getTargetParamsFromTarget( |
|
| 46 | $this->getEntityIdentifierFromTarget( $target ) |
|
| 47 | ); |
|
| 48 | ||
| 49 | $params['language'] = $label->getLanguageCode(); |
|
| 50 | $params['value'] = $label->getText(); |
|
| 51 | ||
| 52 | $this->api->postRequest( 'wbsetlabel', $params, $editInfo ); |
|
| 53 | return true; |
|
| 54 | } |
|
| 55 | ||
| 56 | /** |
|
| 57 | * @param mixed $target |
|
| 58 | * |
|
| 59 | * @throws UnexpectedValueException |
|
| 60 | * |
|
| 61 | * @todo Fix duplicated code |
|
| 62 | */ |
|
| 63 | private function throwExceptionsOnBadTarget( $target ) { |
|
| 64 | if ( !$target instanceof EntityId && !$target instanceof Item && !$target instanceof Property && !$target instanceof SiteLink ) { |
|
| 65 | throw new UnexpectedValueException( '$target needs to be an EntityId, Item, Property or SiteLink' ); |
|
| 66 | } |
|
| 67 | if ( ( $target instanceof Item || $target instanceof Property ) && $target->getId() === null ) { |
|
| 68 | throw new UnexpectedValueException( '$target Entity object needs to have an Id set' ); |
|
| 69 | } |
|
| 70 | } |
|
| 71 | ||
| 72 | /** |
|
| 73 | * @param EntityId|Item|Property $target |
|
| 74 | * |
|
| 75 | * @throws UnexpectedValueException |
|
| 76 | * @return EntityId|SiteLink |
|
| 77 | * |
|
| 78 | * @todo Fix duplicated code |
|
| 79 | */ |
|
| 80 | private function getEntityIdentifierFromTarget( $target ) { |
|
| 81 | if ( $target instanceof Item || $target instanceof Property ) { |
|
| 82 | return $target->getId(); |
|
| 83 | } else { |
|
| 84 | return $target; |
|
| 85 | } |
|
| 86 | } |
|
| 87 | ||
| 88 | /** |
|
| 89 | * @param EntityId|SiteLink $target |
|
| 90 | * |
|
| 91 | * @throws UnexpectedValueException |
|
| 92 | * @return array |
|
| 93 | * |
|
| 94 | * @todo Fix duplicated code |
|
| 95 | */ |
|
| 96 | private function getTargetParamsFromTarget( $target ) { |
|
| 97 | if ( $target instanceof EntityId ) { |
|
| 98 | return [ 'id' => $target->getSerialization() ]; |
|
| 99 | } elseif ( $target instanceof SiteLink ) { |
|
| 100 | return [ |
|
| 101 | 'site' => $target->getSiteId(), |
|
| 102 | 'title' => $target->getPageName(), |
|
| 103 | ]; |
|
| 104 | } else { |
|
| 105 | throw new UnexpectedValueException( '$target needs to be an EntityId or SiteLink' ); |
|
| 106 | } |
|
| 107 | } |
|
| 108 | ||
| 109 | } |
|
| 110 | ||
| @@ 18-108 (lines=91) @@ | ||
| 15 | * |
|
| 16 | * @author Addshore |
|
| 17 | */ |
|
| 18 | class SiteLinkSetter { |
|
| 19 | ||
| 20 | /** |
|
| 21 | * @var WikibaseApi |
|
| 22 | */ |
|
| 23 | private $api; |
|
| 24 | ||
| 25 | /** |
|
| 26 | * @param WikibaseApi $api |
|
| 27 | */ |
|
| 28 | public function __construct( WikibaseApi $api ) { |
|
| 29 | $this->api = $api; |
|
| 30 | } |
|
| 31 | ||
| 32 | /** |
|
| 33 | * @since 0.2 |
|
| 34 | * |
|
| 35 | * @param SiteLink $siteLink |
|
| 36 | * @param EntityId|Item|Property|SiteLink $target |
|
| 37 | * @param EditInfo|null $editInfo |
|
| 38 | * |
|
| 39 | * @return bool |
|
| 40 | */ |
|
| 41 | public function set( SiteLink $siteLink, $target, EditInfo $editInfo = null ) { |
|
| 42 | $this->throwExceptionsOnBadTarget( $target ); |
|
| 43 | ||
| 44 | $params = $this->getTargetParamsFromTarget( |
|
| 45 | $this->getEntityIdentifierFromTarget( $target ) |
|
| 46 | ); |
|
| 47 | ||
| 48 | $params['linksite'] = $siteLink->getSiteId(); |
|
| 49 | $params['linktitle'] = $siteLink->getPageName(); |
|
| 50 | $params['badges'] = implode( '|', $siteLink->getBadges() ); |
|
| 51 | ||
| 52 | $this->api->postRequest( 'wbsetsitelink', $params, $editInfo ); |
|
| 53 | return true; |
|
| 54 | } |
|
| 55 | ||
| 56 | /** |
|
| 57 | * @param mixed $target |
|
| 58 | * |
|
| 59 | * @throws UnexpectedValueException |
|
| 60 | * |
|
| 61 | * @todo Fix duplicated code |
|
| 62 | */ |
|
| 63 | private function throwExceptionsOnBadTarget( $target ) { |
|
| 64 | if ( !$target instanceof EntityId && !$target instanceof Item && !$target instanceof Property && !$target instanceof SiteLink ) { |
|
| 65 | throw new UnexpectedValueException( '$target needs to be an EntityId, Item, Property or SiteLink' ); |
|
| 66 | } |
|
| 67 | if ( ( $target instanceof Item || $target instanceof Property ) && $target->getId() === null ) { |
|
| 68 | throw new UnexpectedValueException( '$target Entity object needs to have an Id set' ); |
|
| 69 | } |
|
| 70 | } |
|
| 71 | ||
| 72 | /** |
|
| 73 | * @param EntityId|Item|Property $target |
|
| 74 | * |
|
| 75 | * @throws UnexpectedValueException |
|
| 76 | * @return EntityId|SiteLink |
|
| 77 | * |
|
| 78 | * @todo Fix duplicated code |
|
| 79 | */ |
|
| 80 | private function getEntityIdentifierFromTarget( $target ) { |
|
| 81 | if ( $target instanceof Item || $target instanceof Property ) { |
|
| 82 | return $target->getId(); |
|
| 83 | } else { |
|
| 84 | return $target; |
|
| 85 | } |
|
| 86 | } |
|
| 87 | ||
| 88 | /** |
|
| 89 | * @param EntityId|SiteLink $target |
|
| 90 | * |
|
| 91 | * @throws UnexpectedValueException |
|
| 92 | * @return array |
|
| 93 | * |
|
| 94 | * @todo Fix duplicated code |
|
| 95 | */ |
|
| 96 | private function getTargetParamsFromTarget( $target ) { |
|
| 97 | if ( $target instanceof EntityId ) { |
|
| 98 | return [ 'id' => $target->getSerialization() ]; |
|
| 99 | } elseif ( $target instanceof SiteLink ) { |
|
| 100 | return [ |
|
| 101 | 'site' => $target->getSiteId(), |
|
| 102 | 'title' => $target->getPageName(), |
|
| 103 | ]; |
|
| 104 | } else { |
|
| 105 | throw new UnexpectedValueException( '$target needs to be an EntityId or SiteLink' ); |
|
| 106 | } |
|
| 107 | } |
|
| 108 | } |
|
| 109 | ||