"required|length[0,255]", "title" => "required|length[0,255]", "description" => "length[0,65535]" ); /** * Add a set of restrictions to any following queries to restrict access only to items * viewable by the active user. * @chainable */ public function viewable() { if (is_null($this->view_restrictions)) { if (user::active()->admin) { $this->view_restrictions = array(); } else { foreach (user::group_ids() as $id) { // Separate the first restriction from the rest to make it easier for us to formulate // our where clause below if (empty($this->view_restrictions)) { $this->view_restrictions[0] = "view_$id"; } else { $this->view_restrictions[1]["view_$id"] = access::ALLOW; } } } } switch (count($this->view_restrictions)) { case 0: break; case 1: $this->where($this->view_restrictions[0], access::ALLOW); break; default: $this->open_paren(); $this->where($this->view_restrictions[0], access::ALLOW); $this->orwhere($this->view_restrictions[1]); $this->close_paren(); break; } return $this; } /** * Is this item an album? * @return true if it's an album */ public function is_album() { return $this->type == 'album'; } /** * Is this item a photo? * @return true if it's a photo */ public function is_photo() { return $this->type == 'photo'; } /** * Is this item a movie? * @return true if it's a movie */ public function is_movie() { return $this->type == 'movie'; } public function delete() { $original_path = $this->file_path(); $original_resize_path = $this->resize_path(); $original_thumb_path = $this->thumb_path(); parent::delete(); if (is_dir($original_path)) { if (file_exists($original_path)) { dir::unlink($original_path); } /* * Both the thumb path and the resize path contain a path to .album.jpg * So we need to try to delete both the path (may not exist) and its directory. */ if (file_exists($original_resize_path)) { unlink($original_resize_path); } if (file_exists(dirname($original_resize_path))) { dir::unlink(dirname($original_resize_path)); } if (file_exists($original_thumb_path)) { unlink($original_thumb_path); } if (file_exists(dirname($original_thumb_path))) { dir::unlink(dirname($original_thumb_path)); } } else { if (file_exists($original_path)) { unlink($original_path); } if (file_exists($original_resize_path)) { unlink($original_resize_path); } if (file_exists($original_thumb_path)) { unlink($original_thumb_path); } } } /** * Move this item to the specified target. * * @chainable * @param Item_Model $target Target item (must be an album * @return ORM_MTPP */ function move_to($target) { if (!$target->is_album()) { throw new Exception("@todo INVALID_MOVE_TYPE $target->type"); } if ($this->id == 1) { throw new Exception("@todo INVALID_SOURCE root album"); } $original_path = $this->file_path(); $original_resize_path = $this->resize_path(); $original_thumb_path = $this->thumb_path(); parent::move_to($target, true); $this->relative_path = null; rename($original_path, $this->file_path()); if ($this->is_album()) { rename(dirname($original_resize_path), dirname($this->resize_path())); rename(dirname($original_thumb_path), dirname($this->thumb_path())); } else { rename($original_resize_path, $this->resize_path()); rename($original_thumb_path, $this->thumb_path()); } return $this; } /** * album: url::site("albums/2") * photo: url::site("photos/3") * * @param string $query the query string (eg "show=3") */ public function url($query=array(), $full_uri=false) { $url = ($full_uri ? url::abs_site("{$this->type}s/$this->id") : url::site("{$this->type}s/$this->id")); if ($query) { $url .= "?$query"; } return $url; } /** * album: /var/albums/album1/album2 * photo: /var/albums/album1/album2/photo.jpg */ public function file_path() { return VARPATH . "albums/" . $this->relative_path(); } /** * album: http://example.com/gallery3/var/resizes/album1/ * photo: http://example.com/gallery3/var/albums/album1/photo.jpg */ public function file_url($full_uri=false) { return $full_uri ? url::abs_file("var/albums/" . $this->relative_path()) : url::file("var/albums/" . $this->relative_path()); } /** * album: /var/resizes/album1/.thumb.jpg * photo: /var/albums/album1/photo.thumb.jpg */ public function thumb_path() { $base = VARPATH . "thumbs/" . $this->relative_path(); if ($this->is_photo()) { return $base; } else if ($this->is_album()) { return $base . "/.album.jpg"; } else if ($this->is_movie()) { // Replace the extension with jpg return preg_replace("/...$/", "jpg", $base); } } /** * album: http://example.com/gallery3/var/resizes/album1/.thumb.jpg * photo: http://example.com/gallery3/var/albums/album1/photo.thumb.jpg */ public function thumb_url($full_uri=false) { $base = ($full_uri ? url::abs_file("var/thumbs/" . $this->relative_path()) : url::file("var/thumbs/" . $this->relative_path())); if ($this->is_photo()) { return $base; } else if ($this->is_album()) { return $base . "/.album.jpg"; } else if ($this->is_movie()) { // Replace the extension with jpg return preg_replace("/...$/", "jpg", $base); } } /** * album: /var/resizes/album1/.resize.jpg * photo: /var/albums/album1/photo.resize.jpg */ public function resize_path() { return VARPATH . "resizes/" . $this->relative_path() . ($this->is_album() ? "/.album.jpg" : ""); } /** * album: http://example.com/gallery3/var/resizes/album1/.resize.jpg * photo: http://example.com/gallery3/var/albums/album1/photo.resize.jpg */ public function resize_url($full_uri=false) { return ($full_uri ? url::abs_file("var/resizes/" . $this->relative_path()) : url::file("var/resizes/" . $this->relative_path())) . ($this->is_album() ? "/.album.jpg" : ""); } /** * Return the relative path to this item's file. * @return string */ public function relative_path() { if (empty($this->relative_path)) { foreach ($this->parents() as $parent) { if ($parent->id > 1) { $paths[] = $parent->name; } } $paths[] = $this->name; $this->relative_path = implode($paths, "/"); } return $this->relative_path; } /** * @see ORM::__get() */ public function __get($column) { if ($column == "owner") { // This relationship depends on an outside module, which may not be present so handle // failures gracefully. try { return model_cache::get("user", $this->owner_id); } catch (Exception $e) { return null; } } else { return parent::__get($column); } } /** * @see ORM::save() */ public function save() { if (!empty($this->changed) && $this->changed != array("view_count" => "view_count")) { $this->updated = time(); if (!$this->loaded) { $this->created = $this->updated; // let albums have a weight of zero so they come first if (!$this->is_album()) { $r = ORM::factory("item")->select("MAX(weight) as max_weight")->find(); $this->weight = $r->max_weight + 1; } } } return parent::save(); } /** * Return the Item_Model representing the cover for this album. * @return Item_Model or null if there's no cover */ public function album_cover() { if (!$this->is_album()) { return null; } if (empty($this->album_cover_item_id)) { return null; } try { return model_cache::get("item", $this->album_cover_item_id); } catch (Exception $e) { // It's possible (unlikely) that the item was deleted, if so keep going. return null; } } /** * Find the position of the given child id in this album. The resulting value is 1-indexed, so * the first child in the album is at position 1. */ public function get_position($child_id) { return ORM::factory("item") ->where("parent_id", $this->id) ->where("id <=", $child_id) ->orderby(array($this->sort_column => $this->sort_order)) ->count_all(); } /** * Return an tag for the thumbnail. * @param array $extra_attrs Extra attributes to add to the img tag * @param int (optional) $max Maximum size of the thumbnail (default: null) * @return string */ public function thumb_tag($extra_attrs=array(), $max=null) { list ($height, $width) = $this->_adjust_thumb_size($max); $attrs = array_merge($extra_attrs, array( "src" => $this->thumb_url(), "alt" => $this->title, "width" => $width, "height" => $height) ); // html::image forces an absolute url which we don't want return ""; } /** * Return an tag for a micro thumbnail. Use margins to center within the specified size * @param array $extra_attrs Extra attributes to add to the img tag * @param int (optional) $max Maximum size of the thumbnail (default: null) * @return string */ public function micro_thumb_tag($extra_attrs=array(), $max=null) { list ($height, $width) = $this->_adjust_thumb_size($max); // The constant is divide by 2 to calcuate the file and 10 to convert to em $margin_top = ($max - $height) / 20; $extra_attrs["style"] = "margin-top: {$margin_top}em"; $attrs = array_merge($extra_attrs, array( "src" => $this->thumb_url(), "alt" => $this->title, "title" => $this->title, "width" => $width, "height" => $height) ); // html::image forces an absolute url which we don't want return ""; } /** * Adjust the height based on the input maximum size or zero if not thumbnail * @param int $max Maximum size of the thumbnail * @return array */ private function _adjust_thumb_size($max) { $width = $this->thumb_width; $height = $this->thumb_height; if ($height) { if (isset($max)) { if ($width > $height) { $height = (int)($max * ($height / $width)); $width = $max; } else { $width = (int)($max * ($width / $height)); $height = $max; } } } else { // Missing thumbnail, can happen on albums with no photos yet. // @todo we should enforce a placeholder for those albums. $width = 0; $height = 0; } return array($height, $width); } /** * Return an tag for the resize. * @param array $extra_attrs Extra attributes to add to the img tag * @return string */ public function resize_tag($extra_attrs) { $attrs = array_merge($extra_attrs, array("src" => $this->resize_url(), "alt" => $this->title, "width" => $this->resize_width, "height" => $this->resize_height) ); // html::image forces an absolute url which we don't want return ""; } public function movie_tag($extra_attrs) { $attrs = array_merge($extra_attrs, array("id" => "player", "style" => "display:block;width:400px;height:300px") ); return html::anchor($this->file_url(true), "", $attrs) . ""; } /** * Return all of the children of this node, ordered by the defined sort order. * * @chainable * @param integer SQL limit * @param integer SQL offset * @return array ORM */ function children($limit=null, $offset=0) { return parent::children($limit, $offset, array($this->sort_column => $this->sort_order)); } /** * Return all of the children of the specified type, ordered by the defined sort order. * * @param integer SQL limit * @param integer SQL offset * @param string type to return * @return object ORM_Iterator */ function descendants($limit=null, $offset=0, $type=null) { return parent::descendants($limit, $offset, $type, array($this->sort_column => $this->sort_order)); } }