Class: atkUpdateStampAttribute
Source Location: /attributes/class.atkupdatestampattribute.inc
Class atkUpdateStampAttribute
Class Overview
|
Attribute for keeping track of last-modification times.
The atkUpdateStampAttribute class can be used to automatically store the date and time of the last modification of a record. To use this attribute, add a DATETIME field to your table and add this attribute to your node. No params are necessary, no initial_values need to be set. The timestamps are generated automatically. This attribute is automatically set to readonly, and to af_hide_add (because we only have the first timestamp AFTER a record is added).
Located in /attributes/class.atkupdatestampattribute.inc [line 39]
Wiki documentation
atkAttribute
|
--atkDateTimeAttribute
|
--atkUpdateStampAttribute
Author(s):
Information Tags:
|
Methods
|
Inherited from parent
|
Inherited From atkDateTimeAttribute
-
atkDateTimeAttribute::$m_date
-
-
atkDateTimeAttribute::$m_time
-
-
atkDateTimeAttribute::$m_timezoneAttribute
-
-
atkDateTimeAttribute::$m_utcOffset
-
Inherited From atkAttribute
-
atkAttribute::$m_column
-
-
atkAttribute::$m_cssclasses
-
-
atkAttribute::$m_dbfieldtype
-
-
atkAttribute::$m_dependees
-
-
atkAttribute::$m_disabledModes
-
-
atkAttribute::$m_flags
-
-
atkAttribute::$m_forceinsert
-
-
atkAttribute::$m_forceupdate
-
-
atkAttribute::$m_htmlid
-
-
atkAttribute::$m_index
-
-
atkAttribute::$m_initialValue
-
-
atkAttribute::$m_initial_hidden
-
-
atkAttribute::$m_label
-
-
atkAttribute::$m_loadType
-
-
atkAttribute::$m_manual_paint
-
-
atkAttribute::$m_maxsize
-
-
atkAttribute::$m_module
-
-
atkAttribute::$m_name
-
-
atkAttribute::$m_onchangecode
-
-
atkAttribute::$m_onchangehandler_init
-
-
atkAttribute::$m_order
-
-
atkAttribute::$m_owner
-
-
atkAttribute::$m_ownerInstance
-
-
atkAttribute::$m_searchmode
-
-
atkAttribute::$m_searchsize
-
-
atkAttribute::$m_sections
-
-
atkAttribute::$m_size
-
-
atkAttribute::$m_storageType
-
-
atkAttribute::$m_tabs
-
|
Inherited From atkDateTimeAttribute
-
atkDateTimeAttribute::atkDateTimeAttribute()
-
Constructor
-
atkDateTimeAttribute::addToQuery()
-
Adds this attribute to database queries.
-
atkDateTimeAttribute::arrayToDateTime()
-
Converts a date array to a timestamp year, month, day are obligatory !!
-
atkDateTimeAttribute::datetimeArray()
-
Converts a date/time string (YYYYMMDDHHMISS) to an array with 5 fields (day, month, year, hours, minutes, seconds).
-
atkDateTimeAttribute::db2value()
-
Convert database value to datetime array
-
atkDateTimeAttribute::dbFieldType()
-
Return the database field type of the attribute.
-
atkDateTimeAttribute::display()
-
Display's html version of Record
-
atkDateTimeAttribute::edit()
-
Returns a piece of html code that can be used in a form to edit this attribute's value.
-
atkDateTimeAttribute::fetchMeta()
-
Fetch the metadata about this attrib from the table metadata, and process it.
-
atkDateTimeAttribute::fetchValue()
-
Convert values from an HTML form posting to an internal value for this attribute.
-
atkDateTimeAttribute::fromUTC()
-
Convert the given UTC ATK date/time array to a date/time array in a certain timezone.
-
atkDateTimeAttribute::getSearchModes()
-
Retrieve the list of searchmodes supported by the attribute.
-
atkDateTimeAttribute::getTimezoneAttribute()
-
Returns the timezone attribute name.
-
atkDateTimeAttribute::getUTCOffset()
-
Returns the UTC offset if set.
-
atkDateTimeAttribute::hide()
-
Returns a piece of html code for hiding this attribute in an HTML form, while still posting its value. (<input type="hidden">)
-
atkDateTimeAttribute::init()
-
Init this attribute
-
atkDateTimeAttribute::parseStringValue()
-
Parse the string to convert a datetime string to an array
-
atkDateTimeAttribute::postInit()
-
If a timezone attribute is set, make sure it's always loaded.
-
atkDateTimeAttribute::resetUTCOffset()
-
Resets the UTC offset.
-
atkDateTimeAttribute::search()
-
Returns a piece of html code that can be used to get search terms input from the user.
-
atkDateTimeAttribute::searchCondition()
-
Creates a search condition for a given search value, and adds it to the query that will be used for performing the actual search.
-
atkDateTimeAttribute::setDateMax()
-
Set the maximum date that may be select (0 means unlimited).
-
atkDateTimeAttribute::setDateMin()
-
Set the minimum date that may be select (0 means unlimited).
-
atkDateTimeAttribute::setTimezoneAttribute()
-
Sets the timezone attribute. This can also be a timezone attribute retrieved from a atkManyToOneRelation. If so then please use the dot notation.
-
atkDateTimeAttribute::setUTCOffset()
-
Sets the UTF offset in seconds.
-
atkDateTimeAttribute::toUTC()
-
Convert the given ATK date/time array to a UTC date/time array.
-
atkDateTimeAttribute::validate()
-
Validate the value of this attribute
-
atkDateTimeAttribute::value2db()
-
Converts the internal attribute value to one that is understood by the database.
-
atkDateTimeAttribute::_getUTCOffset()
-
Returns the UTC offset in seconds. If the UTC offset is set explicitly
Inherited From atkAttribute
-
atkAttribute::atkAttribute()
-
Constructor
-
atkAttribute::addCSSClass()
-
Add a CSS class for this attribute on an HTML form.
-
atkAttribute::addDependee()
-
Indicate that another attribute depends on this attribute, and that if this attribute is updated, the dependent attribute needs to be updated as well.
-
atkAttribute::addDisabledMode()
-
Adds a disabled mode flag to the attribute (use DISABLED_VIEW and DISABLED_EDIT flags).
-
atkAttribute::addFlag()
-
Adds a flag to the attribute.
-
atkAttribute::addOnChangeHandler()
-
Add a javascript onchange event handler.
-
atkAttribute::addToEditArray()
-
Adds the attribute's edit / hide HTML code to the edit array.
-
atkAttribute::addToListArrayHeader()
-
Adds the attribute / field to the list header. This includes the column name and search field.
-
atkAttribute::addToListArrayRow()
-
Adds the attribute / field to the list row. And if the row is totalisable also to the total.
-
atkAttribute::addToQuery()
-
Adds this attribute to database queries.
-
atkAttribute::addToSearchformFields()
-
Adds the needed searchbox(es) for this attribute to the fields array. This method should only be called by the atkSearchHandler.
-
atkAttribute::addToViewArray()
-
Adds the attribute's view / hide HTML code to the view array.
-
atkAttribute::db2value()
-
Converts a database value to an internal value.
-
atkAttribute::dbFieldSize()
-
Return the size of the field in the database.
-
atkAttribute::dbFieldType()
-
Return the database field type of the attribute.
-
atkAttribute::delete()
-
The delete method is called by the framework to inform the attribute that a record is deleted.
-
atkAttribute::deleteAllowed()
-
Check if delete of the record is allowed.
-
atkAttribute::display()
-
Returns a displayable string for this value, to be used in HTML pages.
-
atkAttribute::edit()
-
Returns a piece of html code that can be used in a form to edit this attribute's value.
-
atkAttribute::equal()
-
This function is called to compare if two records are considered equal by this attribute.
-
atkAttribute::escapeSQL()
-
Escape string for use in a query.
-
atkAttribute::extendedSort()
-
Retrieves the sort options and sort order.
-
atkAttribute::fetchMeta()
-
Fetch the metadata about this attrib from the table metadata, and process it.
-
atkAttribute::fetchValue()
-
Convert values from an HTML form posting to an internal value for this attribute.
-
atkAttribute::fieldName()
-
Returns the name of the attribute.
-
atkAttribute::formName()
-
Retrieve the name of the attribute in HTML forms.
-
atkAttribute::getAdditionalTabs()
-
Get list of additional tabs.
-
atkAttribute::getAttributeHtmlId()
-
Returns the html identifier of the attribute without setting it Created because getHtmlId would always SET the htmlid while getting it.
-
atkAttribute::getColumn()
-
Get column.
-
atkAttribute::getCSSClassAttribute()
-
Retrieve the attribute for the HTML-tag for this atkAttribute.
-
atkAttribute::getCSSClasses()
-
Retrieve the CSS classes that were registered for this attribute
-
atkAttribute::getDb()
-
Get database instance for this attribute. Will return the owner instance database instance unless the owner instance is not set in which case the default instance will be returned.
-
atkAttribute::getDependees()
-
Retrieve the dependees for this attribute.
-
atkAttribute::getEdit()
-
Retrieve the HTML code for placing this attribute in an edit page.
-
atkAttribute::getError()
-
Check if this attribute has errors in the specified error list.
-
atkAttribute::getFlags()
-
Returns the full set of flags of the attribute.
-
atkAttribute::getForceInsert()
-
Getter for wether or not an attribute is forced to insert
-
atkAttribute::getForceUpdate()
-
Getter for wether or not an attribute is forced to update
-
atkAttribute::getHtmlId()
-
Return the html identifier (id="") of the attribute. (unique within a
-
atkAttribute::getLabel()
-
Get the HTML label of the attribute.
-
atkAttribute::getModule()
-
Get the module that this attribute originated from.
-
atkAttribute::getOrderByStatement()
-
Retrieves the ORDER BY statement for this attribute's node.
-
atkAttribute::getOwnerInstance()
-
Returns the owner instance.
-
atkAttribute::getRefreshCall()
-
Returns a JavaScript call for refreshing this attribute.
-
atkAttribute::getSearchCondition()
-
Creates a searchcondition for the field, was once part of searchCondition, however, searchcondition() also immediately adds the search condition.
-
atkAttribute::getSearchFieldName()
-
Retrieve the fieldname of the attribute in an atksearch form.
-
atkAttribute::getSearchMode()
-
Retrieve the current set or default searchmode of this attribute
-
atkAttribute::getSearchModeFieldname()
-
Retrieve the searchmode name of the attribute in an atksearch form.
-
atkAttribute::getSearchModes()
-
Retrieve the list of searchmodes supported by the attribute.
-
atkAttribute::getSections()
-
retrieve the tabs and/or sections for this attribute.
-
atkAttribute::getTabs()
-
retrieve the tabs for this attribute.
-
atkAttribute::getToolTip()
-
Retrieve the html/javascript code for showing the tooltip for this attribute.
-
atkAttribute::getView()
-
Retrieve the html code for placing this attribute in a view page.
-
atkAttribute::hasDisabledMode()
-
Check if the attribute is disabled in some mode (use DISABLED_VIEW and DISABLED_EDIT flags).
-
atkAttribute::hasFlag()
-
Check if the attribute has a certain flag.
-
atkAttribute::hasStore()
-
This function is used to check whether a attribute has a store function or not.
-
atkAttribute::hide()
-
Returns a piece of html code for hiding this attribute in an HTML form, while still posting its value. (<input type="hidden">)
-
atkAttribute::init()
-
This function is called right after the attribute is added to the node.
-
atkAttribute::initialValue()
-
Initial value. Returns the initial value for this attribute which will be used in the add form etc.
-
atkAttribute::isDepending()
-
Check whether this attribute depends on other attributes.
-
atkAttribute::isEmpty()
-
Check if a record has an empty value for this attribute.
-
atkAttribute::isInitialHidden()
-
check whether initially hidden or not
-
atkAttribute::isManualPaint()
-
Check wether this attribute should be manually painted (call the edit method) or not.
-
atkAttribute::isNotNullInDb()
-
Checks if this attribute is really not null in the database.
-
atkAttribute::isPosted()
-
Is there a value posted for this attribute?
-
atkAttribute::label()
-
Return the label of the attribute.
-
atkAttribute::listHeaderSortOrder()
-
Retrieve the sortorder for the listheader based on the atkColumnConfig
-
atkAttribute::loadType()
-
Determine the load type of this attribute.
-
atkAttribute::maxInputSize()
-
Determine the maximum length an input field may be.
-
atkAttribute::needsInsert()
-
This function is called by the framework to determine if the attribute needs to be saved to the database in an addDb call.
-
atkAttribute::needsUpdate()
-
This function is called by the framework to determine if the attribute needs to be saved to the database in an updateDb call.
-
atkAttribute::parseStringValue()
-
Convert a String representation into an internal value.
-
atkAttribute::partial()
-
Handle a partial request for this attribute, different attributes support different partials.
-
atkAttribute::partial_refresh()
-
Partial method to refresh the add/edit field for this attribute.
-
atkAttribute::postInit()
-
This function is called at the end of the node's init method.
-
atkAttribute::registerKeyListener()
-
Register keyboard navigation for this attribute.
-
atkAttribute::removeDisabledMode()
-
Removes a disabled mode from the attribute.
-
atkAttribute::removeFlag()
-
Removes a flag from the attribute.
-
atkAttribute::search()
-
Returns a piece of html code that can be used to get search terms input from the user.
-
atkAttribute::searchCondition()
-
Creates a search condition for a given search value, and adds it to the query that will be used for performing the actual search.
-
atkAttribute::searchMode()
-
Returns piece of html which is used for setting/selecting the search mode for this attribute.
-
atkAttribute::setAttribSize()
-
Set the size(s) of the attribute
-
atkAttribute::setAttributeSearchmode()
-
Sets the searchmode for an attribute This will cause attributes that respect this to use the attributes searchmode for that particulair attribute instead of the general searchmode.
-
atkAttribute::setColumn()
-
Set column.
-
atkAttribute::setDisabledModes()
-
Sets the disabled mode flag of the attribute
-
atkAttribute::setFlags()
-
Sets the flags of the attribute
-
atkAttribute::setForceInsert()
-
Used to force an attribute to update with every addDb() call
-
atkAttribute::setForceUpdate()
-
Used to force an attribute to update with every updateDb() call
-
atkAttribute::setInitialHidden()
-
Set whether initially hidden or not. A field is "hidden" by adding the class atkAttrRowHidden.
-
atkAttribute::setInitialValue()
-
Set initial value for this attribute.
-
atkAttribute::setLabel()
-
Set the label of the attribute
-
atkAttribute::setLoadType()
-
Sets the load type.
-
atkAttribute::setManualPaint()
-
Set wether the edit() method of this attribute should be called by the framework, or if the edit method is called manually.
-
atkAttribute::setOwnerInstance()
-
Sets the owner instance.
-
atkAttribute::setSections()
-
Put the attribute on one or more tabs and/or sections.
-
atkAttribute::setStorageType()
-
Sets the storage type.
-
atkAttribute::setTabs()
-
Put the attribute on one or more tabs.
-
atkAttribute::showOnTab()
-
Check if the attribute wants to be shown on a certain tab.
-
atkAttribute::smartSearchCondition()
-
Creates a smart search condition for a given search value, and adds it to the query that will be used for performing the actual search.
-
atkAttribute::sortOptions()
-
Retrieves the sort options for this attribute which is used in recordlists and search actions.
-
atkAttribute::sortOrder()
-
Sets the sortorder options for this attribute which is used in recordlists and search actions.
-
atkAttribute::storageType()
-
Determine the storage type of this attribute.
-
atkAttribute::sum()
-
Calculate the sum of 2 records.
-
atkAttribute::text()
-
Translate using the owner instance's module and type.
-
atkAttribute::validate()
-
Checks if a value is valid.
-
atkAttribute::value2db()
-
Converts the internal attribute value to one that is understood by the database.
-
atkAttribute::_registerDependees()
-
Register change handlers for dependees.
-
atkAttribute::_renderChangeHandler()
-
Renders the onchange code on the page.
-
atkAttribute::__toString()
-
String representation for this attribute (PHP5 only).
|
Method Summary
| array |
getSearchModes() |
Retrieve the list of searchmodes supported by the attribute. |
| String |
hide() |
Returns a piece of html code for hiding this attribute in an HTML form, while still posting its value. (<input type="hidden">) |
Methods
atkUpdateStampAttribute atkUpdateStampAttribute(
String
$name, [int
$flags = 0]
)
|
|
Constructor
Parameters:
|
String |
$name: |
Name of the attribute (unique within a node, and corresponds to the name of the datetime field in the database where the stamp is stored. |
|
int |
$flags: |
Flags for the attribute. |
Retrieve the list of searchmodes supported by the attribute.
API Tags:
| Return: | Array containing "exact" as the only supported searchmode. |
Redefinition of:
- atkDateTimeAttribute::getSearchModes()
- Retrieve the list of searchmodes supported by the attribute.
String hide(
[array
$record = ""], String
$fieldprefix
)
|
|
Returns a piece of html code for hiding this attribute in an HTML form, while still posting its value. (<input type="hidden">)
Parameters:
|
array |
$record: |
The record that holds the value for this attribute |
|
String |
$fieldprefix: |
The fieldprefix to put in front of the name of any html form element for this attribute. |
API Tags:
| Return: | A piece of htmlcode with hidden form elements that post This attribute's value without showing it. |
Redefinition of:
- atkDateTimeAttribute::hide()
- Returns a piece of html code for hiding this attribute in an HTML form, while still posting its value. (<input type="hidden">)
Override the initial value
Redefinition of:
- atkAttribute::initialValue()
- Initial value. Returns the initial value for this attribute which will be used in the add form etc.
The value2db(
array
$record
)
|
|
Value to DB.
Parameters:
|
array |
$record: |
The record |
API Tags:
| Return: | value to store in the database |
Redefinition of:
- atkDateTimeAttribute::value2db()
- Converts the internal attribute value to one that is understood by the database.