Alpha Framework 3.0.0 API Documentation
  • Namespace
  • Class

Namespaces

  • Alpha
    • Controller
      • Front
    • Exception
    • Model
      • Type
    • Task
    • Util
      • Backup
      • Cache
      • Code
        • Highlight
        • Metric
      • Config
      • Convertor
      • Email
      • Extension
      • Feed
      • File
      • Graph
      • Helper
      • Http
        • Filter
        • Session
      • Image
      • Logging
      • Search
      • Security
      • Service
    • View
      • Renderer
        • Html
        • Json
      • Widget

Classes

  • ActionLog
  • ActiveRecord
  • ActiveRecordProviderMySQL
  • ActiveRecordProviderSQLite
  • Article
  • ArticleComment
  • ArticleVote
  • BadRequest
  • BlacklistedClient
  • BlacklistedIP
  • Person
  • Rights
  • Tag

Interfaces

  • ActiveRecordProviderInterface

Class Article

An article class for the CMS.

Alpha\Model\ActiveRecord
Extended by Alpha\Model\Article
Namespace: Alpha\Model
Copyright:

Copyright (c) 2018, John Collins (founder of Alpha Framework). All rights reserved.

Redistribution and use in source and binary forms, with or
without modification, are permitted provided that the
following conditions are met:

* Redistributions of source code must retain the above
  copyright notice, this list of conditions and the
  following disclaimer.
* Redistributions in binary form must reproduce the above
  copyright notice, this list of conditions and the
  following disclaimer in the documentation and/or other
  materials provided with the distribution.
* Neither the name of the Alpha Framework nor the names
  of its contributors may be used to endorse or promote
  products derived from this software without specific
  prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

License: The BSD License
Author: John Collins dev@alphaframework.org
Since: 1.0
Located at Model/Article.php

Methods summary

public
# __construct( )

The constructor which sets up some housekeeping attributes.

The constructor which sets up some housekeeping attributes.

Since

1.0

Overrides

Alpha\Model\ActiveRecord::__construct
protected
# after_save_callback( )

After creating a new Article, tokenize the description field to form a set of automated tags and save them.

After creating a new Article, tokenize the description field to form a set of automated tags and save them.

Since

1.0
protected
# after_loadByAttribute_callback( )

Set up the transient URL attributes for the artcile after it has loaded.

Set up the transient URL attributes for the artcile after it has loaded.

Since

1.0
protected
# after_load_callback( )

Set up the transient URL attributes for the article after it has loaded.

Set up the transient URL attributes for the article after it has loaded.

Since

1.0
public array
# loadRecentWithLimit( integer $limit )

Gets an array of the IDs of the most recent articles added to the system (by date), from the newest article to the amount specified by the $limit.

Gets an array of the IDs of the most recent articles added to the system (by date), from the newest article to the amount specified by the $limit.

Parameters

$limit

Returns

array

Throws

Alpha\Exception\AlphaException

Since

1.0
public string
# getAttachmentsLocation( )

Generates the location of the attachments folder for this article.

Generates the location of the attachments folder for this article.

Returns

string

Since

1.0
public string
# getAttachmentsURL( )

Generates the URL of the attachments folder for this article.

Generates the URL of the attachments folder for this article.

Returns

string

Since

1.0
public
# getAttachmentSecureURL( string $filename )

Generates a secure URL for downloading an attachment file via the ViewAttachment controller.

Generates a secure URL for downloading an attachment file via the ViewAttachment controller.

Parameters

$filename

Since

1.0
public
# createAttachmentsFolder( )

Creates the attachment folder for the article on the server.

Creates the attachment folder for the article on the server.

Throws

Alpha\Exception\AlphaException

Since

1.0
public string
# getArticleScore( )

Method for returning the calculated score for this article.

Method for returning the calculated score for this article.

Returns

string

Since

1.0
public array
# getArticleVotes( )

Method for fetching all of the votes for this article.

Method for fetching all of the votes for this article.

Returns

array
An array of ArticleVote objects

Since

1.0
public boolean
# checkUserVoted( )

Method to determine if the logged-in user has already voted for this article.

Method to determine if the logged-in user has already voted for this article.

Returns

boolean
True if they have voted already, false otherwise

Throws

Alpha\Exception\AlphaException

Since

1.0
public array
# getArticleComments( )

Method for fetching all of the comments for this article.

Method for fetching all of the comments for this article.

Returns

array
An array of ArticleComment objects

Since

1.0
public
# loadContentFromFile( string $filePath )

Loads the content of the ArticleObject from the specified file path.

Loads the content of the ArticleObject from the specified file path.

Parameters

$filePath

Throws

Alpha\Exception\FileNotFoundException

Since

1.0
public boolean
# isLoadedFromFile( )

Returns true if the article content was loaded from a .text file, false otherwise.

Returns true if the article content was loaded from a .text file, false otherwise.

Returns

boolean

Since

1.0
public string
# getContentFileDate( )

Returns the timestamp of when the content .text file for this article was last modified.

Returns the timestamp of when the content .text file for this article was last modified.

Returns

string

Throws

Alpha\Exception\FileNotFoundException

Since

1.0
protected
# setupRels( )

Sets up the Relation definitions on this record object.

Sets up the Relation definitions on this record object.

Since

2.0

Methods inherited from Alpha\Model\ActiveRecord

__wakeup(), addProperty(), addToCache(), backupDatabase(), begin(), cast(), checkDatabaseExists(), checkRecordExists(), checkRecordTableExists(), checkTableExists(), checkTableNeedsUpdate(), commit(), createDatabase(), createForeignIndex(), createUniqueIndex(), delete(), deleteAllByAttribute(), disconnect(), dropDatabase(), dropTable(), findMissingFields(), get(), getCount(), getCreateTS(), getCreatorId(), getDataLabel(), getDataLabels(), getDefaultAttributes(), getFriendlyClassName(), getHistoryCount(), getID(), getIndexes(), getLastQuery(), getMAX(), getMaintainHistory(), getPersistentAttributes(), getPropObject(), getRecordClassNames(), getTableName(), getTaggedAttributes(), getTransientAttributes(), getUniqueAttributes(), getUpdateTS(), getUpdatorId(), getVersion(), getVersionNumber(), hasAttribute(), isInstalled(), isTableOverloaded(), isTagged(), isTransient(), load(), loadAll(), loadAllByAttribute(), loadAllByAttributes(), loadAllByDayUpdated(), loadAllFieldValuesByAttribute(), loadAllOldVersions(), loadByAttribute(), loadClassDef(), loadFromCache(), makeHistoryTable(), makeTable(), markPersistent(), markTransient(), markUnique(), populateFromArray(), query(), rebuildTable(), reload(), removeFromCache(), rollback(), save(), saveAttribute(), saveHistory(), saveRelations(), set(), setDataLabels(), setEnumOptions(), setID(), setLastQuery(), setMaintainHistory(), toArray(), validate()

Constants summary

string TABLE_NAME

The name of the database table for the class.

The name of the database table for the class.

Since

1.0
# 'Article'

Properties summary

protected Alpha\Model\Type\SmallText $title

The article title.

The article title.

Since

1.0
#
protected Alpha\Model\Type\SmallText $description

The description of the article.

The description of the article.

Since

1.0
#
protected Alpha\Model\Type\SmallText $bodyOnload

Optional custom body onload Javascript.

Optional custom body onload Javascript.

Since

1.0
#
protected Alpha\Model\Type\Text $headerContent

Any custom HTML header content (e.g. Javascript) for the article.

Any custom HTML header content (e.g. Javascript) for the article.

Since

1.0
#
protected Alpha\Model\Type\Text $content

The article content.

The article content.

Since

1.0
#
protected Alpha\Model\Type\SmallText $author

The author of the article.

The author of the article.

Since

1.0
#
protected Alpha\Model\Type\Boolean $published

A boolean to control whether the artcile is publically accessible or not.

A boolean to control whether the artcile is publically accessible or not.

Since

1.0
#
protected Alpha\Model\Type\Relation $comments

A Relation containing all of the comments on this article.

A Relation containing all of the comments on this article.

Since

1.0
#
protected Alpha\Model\Type\Relation $votes

A Relation containing all of the votes on this article.

A Relation containing all of the votes on this article.

Since

1.0
#
protected Alpha\Model\Type\Relation $tags

A Relation containing all of the tags on this article.

A Relation containing all of the tags on this article.

Since

1.0
#
protected array $taggedAttributes

An array of all of the attributes on this Record which are tagged.

An array of all of the attributes on this Record which are tagged.

Since

1.0
# array('title', 'description', 'content')
protected array $dataLabels

An array of data display labels for the class properties.

An array of data display labels for the class properties.

Since

1.0
# array('ID' => 'Article ID#', 'title' => 'Title', 'description' => 'Description', 'bodyOnload' => 'Body onload Javascript', 'content' => 'Content', 'headerContent' => 'HTML Header Content', 'author' => 'Author', 'created_ts' => 'Date Added', 'updated_ts' => 'Date of last Update', 'published' => 'Published', 'URL' => 'URL', 'printURL' => 'Printer version URL', 'comments' => 'Comments', 'votes' => 'Votes', 'tags' => 'Tags')
protected string $URL

The URL for this article (transient).

The URL for this article (transient).

Since

1.0
#
protected string $printURL

The print URL for this article (transient).

The print URL for this article (transient).

Since

1.0
#

Properties inherited from Alpha\Model\ActiveRecord

$ID, $created_by, $created_ts, $defaultAttributes, $lastQuery, $transientAttributes, $uniqueAttributes, $updated_by, $updated_ts, $version_num

Alpha Framework 3.0.0 API Documentation API documentation generated by ApiGen