Refs #3209: Adds property docs for the four main entity classes

diff --git a/engine/classes/ElggGroup.php b/engine/classes/ElggGroup.php
index 0190e5eacc31c39c744b0f36a7b0163990e91951..ab223e1a4f012dd2109c1e66c7f2ef44698446ee 100644 (file)
--- a/engine/classes/ElggGroup.php
+++ b/engine/classes/ElggGroup.php
@@ -5,6 +5,9 @@
  *
  * @package    Elgg.Core
  * @subpackage Groups
+ * 
+ * @property string $name        A short name that captures the purpose of the group
+ * @property string $description A longer body of content that gives more details about the group
  */
 class ElggGroup extends ElggEntity
        implements Friendable {

diff --git a/engine/classes/ElggObject.php b/engine/classes/ElggObject.php
index 0b8340697893d9371d00a914be6b3b314847a26f..582308f2852136d935c16557e745a0c357d7bc35 100644 (file)
--- a/engine/classes/ElggObject.php
+++ b/engine/classes/ElggObject.php
@@ -14,6 +14,9 @@
  *
  * @package    Elgg.Core
  * @subpackage DataModel.Object
+ * 
+ * @property string $title       The title, name, or summary of this object
+ * @property string $description The body, description, or content of the object
  */
 class ElggObject extends ElggEntity {
 

diff --git a/engine/classes/ElggSite.php b/engine/classes/ElggSite.php
index 3ccb146fb0ed57cec181eb1adb08ee7e66371034..6860465128a5b3bef3a20c76d6e33ffc42e75a8b 100644 (file)
--- a/engine/classes/ElggSite.php
+++ b/engine/classes/ElggSite.php
@@ -21,6 +21,10 @@
  * @package    Elgg.Core
  * @subpackage DataMode.Site
  * @link       http://docs.elgg.org/DataModel/Sites
+ * 
+ * @property string $name        The name or title of the website
+ * @property string $description A motto, mission statement, or description of the website
+ * @property string $url         The root web address for the site, including trailing slash
  */
 class ElggSite extends ElggEntity {
 

diff --git a/engine/classes/ElggUser.php b/engine/classes/ElggUser.php
index a1c7147a58ffe7f0ab25401fd79b12658c09a24c..ab0610ac02901a46f3c6756d857ccd874b547878 100644 (file)
--- a/engine/classes/ElggUser.php
+++ b/engine/classes/ElggUser.php
@@ -6,6 +6,15 @@
  *
  * @package    Elgg.Core
  * @subpackage DataModel.User
+ * 
+ * @property string $name     The display name that the user will be known by in the network
+ * @property string $username The short, reference name for the user in the network
+ * @property string $email    The email address to which Elgg will send email notifications
+ * @property string $language The language preference of the user (ISO 639-1 formatted)
+ * @property string $banned   'yes' if the user is banned from the network, 'no' otherwise
+ * @property string $admin    'yes' if the user is an administrator of the network, 'no' otherwise
+ * @property string $password The hashed password of the user
+ * @property string $salt     The salt used to secure the password before hashing
  */
 class ElggUser extends ElggEntity
        implements Friendable {