app/soc/models/linkable.py
changeset 2162 03ed2fa5ccc8
parent 1970 385ce0c25bd0
equal deleted inserted replaced
2161:3b5e0e0880cd 2162:03ed2fa5ccc8
   106   For many entities, link IDs, once specified, are immutable, since
   106   For many entities, link IDs, once specified, are immutable, since
   107   changing them can break bookmarked URLs.  Changing the link IDs of
   107   changing them can break bookmarked URLs.  Changing the link IDs of
   108   "leaf" entities (such as the Document in the example above) could
   108   "leaf" entities (such as the Document in the example above) could
   109   be allowed. 
   109   be allowed. 
   110   """
   110   """
   111   #: Required field storing "ID" used in URL links. Lower ASCII characters,
   111   #: Required field storing "ID" used in URL links. ASCII characters,
   112   #: digits and underscores only.  Valid link IDs successfully match
   112   #: digits and underscores only.  Valid link IDs successfully match
   113   #: the LINK_ID_REGEX.
   113   #: the LINK_ID_REGEX.
   114   link_id = db.StringProperty(required=True,
   114   link_id = db.StringProperty(required=True,
   115       verbose_name=ugettext('Link ID'))
   115       verbose_name=ugettext('Link ID'))
   116   link_id.help_text = ugettext(
   116   link_id.help_text = ugettext(
   117       'Link ID is used as part of various URL links throughout the site.'
   117       'Link ID is used as part of various URL links throughout the site.'
   118       ' Lowercase ASCII characters, digits, and underscores only.'
   118       ' <a href="http://en.wikipedia.org/wiki/ASCII">ASCII</a> '
       
   119       ' characters, digits, and underscores only.'
   119       ' The regexp used to validate is "%s".') % LINK_ID_PATTERN_CORE
   120       ' The regexp used to validate is "%s".') % LINK_ID_PATTERN_CORE
   120 
   121 
   121   #: Optional Self Reference property to another Linkable entity which defines
   122   #: Optional Self Reference property to another Linkable entity which defines
   122   #: the "scope" of this Linkable entity. The back-reference in the Linkable 
   123   #: the "scope" of this Linkable entity. The back-reference in the Linkable 
   123   #: model is a Query named 'links'.
   124   #: model is a Query named 'links'.