History of LibertyServices

Differences from version 11 to 22



@@ -35,56 +35,49 @@

 !!Service Options
 This is a list of the available service methods developers can register their own service functions to. These assume some knowledge of how ((bitweaverPackage|bitweaver Packages)) work:
 
+Note that these functions all take a $pObject and $pParamHash arguments where $pObject is the content object being worked on and $pParamHash is a hash of options. SQL functions may return a hash with select_sql, where_sql, join_sql and bind_vars set to effect the sql query being built.
+
 !!! Sql Extensions
-__content_list_sql_function__
-Allows the extension of existing SQL while getList() is called. table aliases are kept constant throughout so you can easily join pertinent data to the existing SQL when getList() is called from any package. You can also insert some select_sql as well, to limit the selection critieria.
-
-__content_load_sql_function__
-This is basically the same as content_list_sql_function but it's called during the load() process. the output should be virtually the same.
+;content_list_sql_function: Allows the extension of existing SQL while getList() is called. table aliases are kept constant throughout so you can easily join pertinent data to the existing SQL when getList() is called from any package. You can also insert some select_sql as well, to limit the selection critieria.
+;content_load_sql_function: This is basically the same as content_list_sql_function but it's called during the load() process. the output should be virtually the same.
 
 
 !!! Functions
-__content_display_function__
-This function is called during the displaying of the content, i.e. while the page is being loaded. this means, you can add more sophisticated queries and checks in here, if there is no possibility to do this with the SQL functions above.
-
-__content_preview_function__
-This function is called when a page is being editied and a user hits preview. it's mostly there for you to make any selections the user has made persistent during the preview phase.
-
-__content_edit_function__
-When a user wants to edit content, this function is called. it allows you to generate data for any templates you need to fill in the edit page (more below).
-
-__content_store_function__
-Here you can store the content data in your serice tables.
-
-__content_expunge_function__
-Make sure the data from your tables is removed when a user removes the content it belongs to.
-
+;content_load_function: This function is called during the load process of the content, i.e. while the page is being loaded before the display function. this is good for things that should happen early on but the sql function is called too soon.
+;content_display_function: This function is called during the displaying of the content, i.e. while the page is being loaded. this means, you can add more sophisticated queries and checks in here, if there is no possibility to do this with the SQL functions above.
+;content_list_function: This function is called on list pages such as when you're viewing the list of wiki pages or the list of articles.
+;content_list_history_function: This function is called on history listing pages when you are viewing a history of changes.
+;content_preview_function: This function is called when a page is being editied and a user hits preview. it's mostly there for you to make any selections the user has made persistent during the preview phase.
+;content_edit_function: When a user wants to edit content, this function is called. it allows you to generate data for any templates you need to fill in the edit page (more below).
+;content_store_function: Here you can store the content data in your serice tables.
+;comment_store_function: Similar to content_store_function, this service is called after a comment object is completely stored.
+;content_expunge_function: Make sure the data from your tables is removed when a user removes the content it belongs to.
+;content_user_perms_function: Modify the user's permissions for a content object. Generally intended for extending permissions. But this gives access to the user's permission hash for manipulation in whichever way.
+;content_verify_access: Verify user has permission to access content. intended use is to fatal out if not.
 
 !!! Templates
-__content_edit_tab_tpl__
-This template is displayed as a seperate tab when a user is editing content. this is useful for services that might contain several lines of code and want to have their own section when a user edits a page. This template is only available when the user is editing data.
+;content_edit_tab_tpl: This template is displayed as a seperate tab when a user is editing content. this is useful for services that might contain several lines of code and want to have their own section when a user edits a page. This template is only available when the user is editing data.
+;content_list_options_tpl: This template is displayed above the content listing and is the the ideal position for adding a filter or some other means of content listing limitation.
+;content_list_sort_tpl: This template is added to the available sort options. This only makes sense if the content_list_actions_tpl is in use as well.
+;content_list_actions_tpl: The contents of this template are displayed within the listing near the action icons for every individual listing entry. Ideal to display relevant service information such as rating or status.
+;content_upload_tab_tpl: This template is displayed as a seperate tab when a user is on a page where they can upload files. the point of this template is to then display files that were uploaded or placed on the server in a method other than uploaded through bitweaver, e.g.: via ftp.
+;content_edit_mini_tpl: This template is displayed during the edit process and is particularly useful when you have a single dropdown to display, since it's displayed below the textarea a user uses to edit the content. This template is only available when the user is editing data.
+;content_view_tpl: This template is appended to the bottom of the page, like a list of pages in the same category. This is only visible when the full content is loaded i.e.: when an article is being read but not just viewed on the front page.
+;content_nav_tpl: You can use this to insert a narrow template at the top of a page. this can be useful to display the path to an object or the status of a page. This is only visible when the full content is loaded i.e.: when an article is being read but not just viewed on the front page.
+;content_icon_tpl: insert an icon in the list of existing icons in the top right on a page. This will enable you to get your users to link to a template in your own package and deal with certain needs that way.
+;content_body_tpl: insert a small template into the top of the <div class="body"> part of the content. this template will be visible in listings such as the articles front page as well.
+;content_list_tpl: insert a small template into each row of a list. Like in a list of wiki pages or board topics. This is for displaying list services in data lists instead of using body which is for abbreviated content lists like recent blog posts are recent articles, see content_body_tpl above.
 
-__content_edit_mini_tpl__
-This template is displayed during the edit process and is particularly useful when you have a single dropdown to display, since it's displayed below the textarea a user uses to edit the content. This template is only available when the user is editing data.
 
-__content_view_tpl__
-This template is appended to the bottom of the page, like a list of pages in the same category. This is only visible when the full content is loaded i.e.: when an article is being read but not just viewed on the front page.
+!!! Users Services Functions
+These are made available via UsersPackage
+;users_register_function: This function is called after a new user registers and their information is validated. Technically it is called on the first time a user logs in, so no matter the validation requirement, instant approval, email verification, etc, this service is not called until the new user is considered valid by bitweaver. This function is great for creating package specific user information.
 
-__content_nav_tpl__
-You can use this to insert a narrow template at the top of a page. this can be useful to display the path to an object or the status of a page. This is only visible when the full content is loaded i.e.: when an article is being read but not just viewed on the front page.
-
-__content_icon_tpl__
-insert an icon in the list of existing icons in the top right on a page. This will enable you to get your users to link to a template in your own package and deal with certain needs that way.
-
-__content_body_tpl__
-insert a small template into the top of the <div class="body"> part of the content. this template will be visible in listings such as the articles front page as well.
+!!! Users Services Templates
+;user_register_inc_tpl: this template lets you append form information to the user registration form.
 
 
 !!! Commerce Functions
 This are made available via BitCommercePackage
-__commerce_pre_purchase_function__
-Provides a way for any package to perform actions moments before a payment is made
-
-__commerce_post_purchase_function__
-Provides a way for any package to perform actions moments after a successful payment is made
-
+;commerce_pre_purchase_function: Provides a way for any package to perform actions moments before a payment is made
+;commerce_post_purchase_function: Provides a way for any package to perform actions moments after a successful payment is made
Page History
Date/CommentUserIPVersion
21 Aug 2010 (15:54 UTC)
Will69.203.72.16122
Current • Source
Will69.203.72.16121
View • Compare • Difference • Source
spiderr66.194.217.22220
View • Compare • Difference • Source
xing62.47.250.1419
View • Compare • Difference • Source
WaterDragon82.171.181.20818
View • Compare • Difference • Source
Will69.203.72.16117
View • Compare • Difference • Source
Will69.203.72.16116
View • Compare • Difference • Source
xing194.152.164.4515
View • Compare • Difference • Source
Will68.174.111.4714
View • Compare • Difference • Source
Will68.174.111.4713
View • Compare • Difference • Source
xing194.152.164.4512
View • Compare • Difference • Source
Will68.174.111.4711
View • Compare • Difference • Source
Will68.174.111.4710
View • Compare • Difference • Source
Will68.174.111.479
View • Compare • Difference • Source
Will68.174.111.478
View • Compare • Difference • Source
spiderr66.93.240.2046
View • Compare • Difference • Source
spiderr66.93.240.2044
View • Compare • Difference • Source
spiderr66.93.240.2041
View • Compare • Difference • Source