= libACR Project =

libACR is an open source Python content management system library for [http://www.turbogears.org "Turbogears"] [[BR]]
It provides a set of tools to implement CMS functions inside any Turbogears2 application and comes with ACRCMS which is a simple and free web content management system implemented with libACR as an example of how to use the library.[[BR]]
[[BR]]
'''If you were looking for the ACRCMS project which uses libACR as its core probably what you were looking for is http://www.acrcms.org'''

ACR divides pages in Slices, which define what should be placed, where it should be placed and how it should be displayed[[BR]]
Each Content can be used in more then one Slice and Slices can be rendered in both complete and preview mode.[[BR]]
Using this interaction you can produce behaviours like having your blog post in its own page and a preview of it inside your main page, or have a photo/video and a preview of it inside your media gallery. ACR already supports previews of HTML documents, images and videos by generating thumbnails for the last two.

'''ACR currently supports''':
 * Multilanguage Content Support
 * Automatic translation using Google when translating content to a new language
 * Content versioning and revert
 * Image Galleries
 * Video Galleries
 * News/Blog Sections
 * Users permissions
 * Autogenerated Vertical/Horizontal Menus
 * Internal Search Engine
 * File Attachments
 * Remote Disk to upload and manage files
 * RSS Integration
 * Twitter Integration
 * Static and Dynamic Google Maps
 * Comments by users
 * Automatic Forms generation with email submission of data

== Screenshots ==

|| [[Image(htdocs:acr_theme_thumb.png, link=http://labs.axant.it/acr/chrome/site/acr_theme.png)]] || [[Image(htdocs:acr_edit_thumb.png, link=http://labs.axant.it/acr/chrome/site/acr_edit.png)]] || [[Image(htdocs:acr_slice_thumb.png, link=http://labs.axant.it/acr/chrome/site/acr_slice.png)]] || [[Image(htdocs:ACR_dashboard_thumb.png, link=http://labs.axant.it/acr/chrome/site/ACR_dashboard.png)]] ||
|| ACR default theme || ACR in Edit Mode || ACR Edit Slice Dialog || ACR Administration Dashboard ||
|| [[Image(htdocs:ACR_pages_thumb.png, link=http://labs.axant.it/acr/chrome/site/ACR_pages.png)]] || [[Image(htdocs:ACR_editpage_thumb.png, link=http://labs.axant.it/acr/chrome/site/ACR_editpage.png)]] || [[Image(htdocs:ACR_content_thumb.png, link=http://labs.axant.it/acr/chrome/site/ACR_content.png)]] || [[Image(htdocs:ACR_remotedisk_thumb.png, link=http://labs.axant.it/acr/chrome/site/ACR_remotedisk.png)]] ||
|| ACR Pages Administration || ACR Page Editing || ACR Content Editing || ACR Remote Disk ||

[[BR]]

== CMS user Guide ==

Download the ACR user Guide in PDF format [http://labs.axant.it/acr/chrome/site/Guide.pdf HERE]

== Features ==

=== Views ===
MenuView, HtmlView, SliceGroupView, FileView, GenshiView, AjaxView,[[BR]]
LinkView, RemoteDisk, RssView, TwitterRssView, CommentsView, MapView,[[BR]]
SearchView, ImageView, VideoView, FormView

=== Templates ===
YoutubeVideo, PhotoGallery, NewsBlog

== Download ==

ACR is released under the GNU General Public License and can be downloaded by simply performing

{{{
 hg clone -u acr http://repo.axant.it/hg/acr
}}}

Follow InstallingAcr for an quick guide on how to install ACR

== Content, View, Slice ==
 '''Content'''::
  It is the pure data, it is usually not represented in any particular way and it is not intended to be seen by humans.[[BR]]
  Content has a name, a creation time and a set of related Tags[[BR]]

 '''View'''::
  It is a way to show a Content[[BR]]
  It has a name and a type which defines which type of contents it can accept (types are like: text, urls, ini configuration etc)[[BR]]
  Managers can defined new Views by both registering them inside the ViewManager of ACR or by defining them using the Administration tools[[BR]]

 '''Slice'''::
  It is a relation between a View and a Content[[BR]]
  Slices have a View, a Content and might be part of one or more pages, they also define the Zone where they should be rendered and an order[[BR]]
  They can also have one or more tags.

== Pages ==
ACR defines Pages as a group of Slices having an uri, a parent Page and a title[[BR]]
Each Slice has notion about where it should be placed when inside a page and in which order if there is any other slice in the same zone[[BR]]
By default ACR defines ''header'',''footer'',''main'',''leftbar'',''rightbar'' zones but those can be expanded registering any number of zones.