create the disabled_registration site tag that allows to remove a specific site from...

[plcapi.git] / PLC / Accessors / Accessors_site.py

diff --git a/PLC/Accessors/Accessors_site.py b/PLC/Accessors/Accessors_site.py
index 7955395..b51d42e 100644 (file)
--- a/PLC/Accessors/Accessors_site.py
+++ b/PLC/Accessors/Accessors_site.py
@@ -4,21 +4,16 @@
 # Accessors_site.py is the place where you can define your own local tag accessors
 # this will not be overwritten through rpm upgrades
 #
+# Historical note: now that Sites are taggable too, the name may be confusing, 
+# think of this as Accessors_local.py
+#
 # to ensure creation of new tag_types, just run 
 #   service plc start accessors
-# also for the running service to take the new accessors into account, you need to
+# also for the running API to take the new accessors into account, you need to
 #   apachectl restart
 # or to stay on the safe side, simply do
 #   service plc restart
 #
-# please note however that if a tag_type already exists in the DB, then 
-# changing the corresponding accessors creation code WILL NOT alter the 
-# tag_type in the DB; that applies to roles and other desc. or categ. 
-# you will thus need to apply them manually 
-#
-# Now that Sites are taggable too, the name may be confusing, think of is as
-# Accessors_local.py
-#
 # methods denotes the set of methods (names) that get inserted into the API
 # it is updated by define_accessors
 
@@ -29,7 +24,6 @@ from PLC.Interfaces import Interface
 from PLC.Slices import Slice
 from PLC.Sites import Site
 from PLC.Persons import Person
-#from PLC.Ilinks import Ilink
 
 from PLC.Accessors.Factory import define_accessors, all_roles, person_roles, tech_roles
 
@@ -37,9 +31,18 @@ import sys
 current_module = sys.modules[__name__]
 
 #### example : attach vlan ids on interfaces
-# The third argument expose_in_api is a boolean flag that tells whether this tag may be handled
-#   through the Add/Get/Update methods as a native field
 #
 #define_accessors(current_module, Interface, "Vlan", "vlan",
 #                  "interface/general", "tag for setting VLAN id",
 #                  get_roles=all_roles, set_roles=tech_roles)
+#
+# The optional expose_in_api is a boolean flag that tells whether this tag may be handled
+#   through the Add/Get/Update methods as a native field
+# e.g. 
+#define_accessors(current_module, Node, "Foo", "foo",
+#                  "node/example", "my own description for foo",
+#                  get_roles=all_roles, set_roles=all_roles)
+# will let you do
+# GetNodes ( {'foo':'*bar*'},['hostname','foo'])
+#
+#