@@ -93,8 +103,9 @@ class Source_HistoryTheme extends Themelet {
$page->add_block(new Block("Navigation", $nav, "left"));
}
- /*
+ /**
* Add a section to the admin page.
+ * @param string $validation_msg
*/
public function display_admin_block(/*string*/ $validation_msg='') {
global $page;
@@ -129,7 +140,11 @@ class Source_HistoryTheme extends Themelet {
$html = implode($this->messages, "\n");
$page->add_block(new Block("Bulk Revert Results", $html));
}
-
+
+ /**
+ * @param string $title
+ * @param string $body
+ */
public function add_status(/*string*/ $title, /*string*/ $body) {
$this->messages[] = '
'. $title .'
'. $body .'
';
}
diff --git a/ext/statsd/main.php b/ext/statsd/main.php
index a365183a..c80acd39 100644
--- a/ext/statsd/main.php
+++ b/ext/statsd/main.php
@@ -76,6 +76,9 @@ class StatsDInterface extends Extension {
StatsDInterface::$stats["shimmie.events.info-sets"] = "1|c";
}
+ /**
+ * @return int
+ */
public function get_priority() {return 99;}
diff --git a/ext/tag_edit/main.php b/ext/tag_edit/main.php
index 43b7d247..af70092d 100644
--- a/ext/tag_edit/main.php
+++ b/ext/tag_edit/main.php
@@ -126,13 +126,17 @@ class LockSetEvent extends Event {
class TagTermParseEvent extends Event {
var $term = null;
var $id = null;
- var $metatag = false;
+ /** @var bool */
+ public $metatag = false;
public function __construct($term, $id) {
$this->term = $term;
$this->id = $id;
}
+ /**
+ * @return bool
+ */
public function is_metatag() {
return $this->metatag;
}
@@ -172,7 +176,11 @@ class TagEdit extends Extension {
global $user;
if($user->can("edit_image_owner")) {
$owner = User::by_name($_POST['tag_edit__owner']);
- send_event(new OwnerSetEvent($event->image, $owner));
+ if ($owner instanceof User) {
+ send_event(new OwnerSetEvent($event->image, $owner));
+ } else {
+ throw new NullUserException("Error: No user with that name was found.");
+ }
}
if($this->can_tag($event->image) && isset($_POST['tag_edit__tags'])) {
send_event(new TagSetEvent($event->image, $_POST['tag_edit__tags']));
@@ -224,7 +232,10 @@ class TagEdit extends Extension {
$this->theme->display_mass_editor();
}
- // When an alias is added, oldtag becomes inaccessable
+ /**
+ * When an alias is added, oldtag becomes inaccessible.
+ * @param AddAliasEvent $event
+ */
public function onAddAlias(AddAliasEvent $event) {
$this->mass_tag_edit($event->oldtag, $event->newtag);
}
@@ -247,16 +258,28 @@ class TagEdit extends Extension {
if(!empty($matches)) $event->metatag = true;
}
+ /**
+ * @param Image $image
+ * @return bool
+ */
private function can_tag(Image $image) {
global $user;
return ($user->can("edit_image_tag") || !$image->is_locked());
}
+ /**
+ * @param Image $image
+ * @return bool
+ */
private function can_source(Image $image) {
global $user;
return ($user->can("edit_image_source") || !$image->is_locked());
}
+ /**
+ * @param string $search
+ * @param string $replace
+ */
private function mass_tag_edit($search, $replace) {
global $database;
@@ -313,6 +336,10 @@ class TagEdit extends Extension {
}
}
+ /**
+ * @param string|string[] $tags
+ * @param string $source
+ */
private function mass_source_edit($tags, $source) {
$tags = Tag::explode($tags);
diff --git a/ext/update/main.php b/ext/update/main.php
index 8804e787..cd70f1cd 100644
--- a/ext/update/main.php
+++ b/ext/update/main.php
@@ -46,6 +46,9 @@ class Update extends Extension {
}
}
+ /**
+ * @return bool
+ */
private function download_shimmie() {
global $config;
@@ -70,6 +73,9 @@ class Update extends Extension {
return false;
}
+ /**
+ * @return bool
+ */
private function update_shimmie() {
global $config, $page;
", $text);
return $text;
}
+ /**
+ * @param string $text
+ * @return string
+ */
public function strip(/*string*/ $text) {
return $text;
}
}
+/**
+ * Class EmoticonList
+ */
class EmoticonList extends Extension {
public function onPageRequest(PageRequestEvent $event) {
if($event->page_matches("emote/list")) {
diff --git a/ext/emoticons/theme.php b/ext/emoticons/theme.php
index dff9f98a..07f033dd 100644
--- a/ext/emoticons/theme.php
+++ b/ext/emoticons/theme.php
@@ -1,5 +1,8 @@
add_block(new Block("Random Image", $this->build_random_html($image), "left", 8));
}
- public function build_random_html(Image $image, $query=null)
- {
+ /**
+ * @param Image $image
+ * @param null|string $query
+ * @return string
+ */
+ public function build_random_html(Image $image, $query = null)
+ {
- $i_id = int_escape($image->id);
- $h_view_link = make_link("post/view/$i_id", $query);
- $h_thumb_link = $image->get_thumb_link();
- $h_tip = html_escape($image->get_tooltip());
- $tsize = get_thumbnail_size($image->width, $image->height);
+ $i_id = int_escape($image->id);
+ $h_view_link = make_link("post/view/$i_id", $query);
+ $h_thumb_link = $image->get_thumb_link();
+ $h_tip = html_escape($image->get_tooltip());
+ $tsize = get_thumbnail_size($image->width, $image->height);
- return "
+ return "