Custodian CMS is a PHP driven Content Management System (CMS) designed to help build and maintain multilingual websites. To lean more visite us at:
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
ccmslib
ccmspre
ccmstpl
ccmsusr
.gitignore
.htaccess
README.md
ccms-setup-db.sql
ccms-setup.php
composer.json
index.php
robots.txt

README.md

Custodian CMS

The word 'Custodian' is defined by thefreedictionary.com as 'A person entrusted with guarding or maintaining a property; caretaker' and this suits the definition of the Custodian CMS very well.

Custodian CMS (CCMS) is a good caretaker to build your site upon because:

  1. It combines the best security practices against techniques like hot linking, cross site scripting, remote code execution and MySQL injection in multiple areas of the system. The .htaccess file is approx. 275 lines of deeply scrutinized code that is constantly being improved. Other .htaccess files found throughout its structure provide additional layers of protection.
  2. It operates under a clearly defined URI structure that is optimal for Search Engines.
  3. It provides an easy process and structure for developers to separate HTML from programming code so that its easier for junior developers and maintainers to work with after development is complete.
  4. It provides the simplest method in existence to solve the issues of constructing multilingual websites using a single set of templates, on a single domain, containing an unlimited number of languages.
  5. It simplifies the user experience by determining language preference automatically.
  6. It gets out of the way of developers to build sites the way they want, with the tools/plugins/frameworks they want, using the themes they want.

Though CCMS does not come with setup scripts or an admin system currently (Admin system will be ready in v1.0) fortunately CCMS is so simple neither one is required to make use of this amazing tool. Use a simple text editor to update the config and a tool like phpMyAdmin to add, remove or update your database inserts.

About

CCMS is a small, light weight, multilingual, Content Management System distributed for free under the GNU LGPL.

The primary purpose of CCMS is to maintain a database of multilingual content and make it easy to display the correct one using a single set of templates. One website, one set of templates, many languages. The website developer sets the default language for the site, adds support for additional languages, fills the database with individually hand crafted blobs of content and inserts CCMS_DB tags throughout the HTML to automatically replace content in the language requested by visitors. Here is an example of the database content insertion tag used in CCMS.

{CCMS_DB:about_us_page,first_paragraph}
{CCMS_DB:use_anywhere,form_button_submit}
{CCMS_DB:trips_to_mexico_template,request_more_info_text1}

If your site contains content which may need to be displayed bidirectional (BIDI) you can use the CCMS_DB_DIR tag to help output left-to-right (lrt) or right-to-left (rtl) flags to use in your HTML.

{CCMS_DB_DIR:about_us_page,first_paragraph}
{CCMS_DB_DIR:use_anywhere,form_button_submit}
{CCMS_DB_DIR:trips_to_mexico_template,request_more_info_text1}

CCMS also provides a framework to help website developers build Search Engine Optimized (SEO)/friendly URIs and insert one template into another (CCMS_TPL tags) or libraries of custom code with the template they are currently working on (CCMS_LIB tags).

{CCMS_TPL:header.html}
{CCMS_TPL:somedir/footer.html}
{CCMS_TPL:products/list.php}

{CCMS_LIB:_default.php;FUNC:ccms_cfgDomain}
{CCMS_LIB:cms/_123.php;FUNC:XyZZy123_}
{CCMS_LIB:test/dir/indeX_Asdf-123.php;FUNC:cfgindeX_Asdf123("arg1", "arg2")}

Visit the project website at https://custodiancms.org

System requirements

LAMP

  • Linux
  • Apache
  • MySQL v5.5.3+
  • PHP v5.4+

(CCMS will probably run on IIS but ya never know. If someone would like to test it and let me know I'd appreciate it.)

Installation

You can now use a single template to download CCMS and begin the config/setup process. Download it here: Custodian CMS Installer

Or use the original method below to install.

  • Download a CCMS package from https://github.com/modusinternet/custodian-cms/releases.
  • Unpack and place the archive on your server.
  • Import ccms-db-setup.sql into your MySQL editor after setting up a new database.
  • Update the settings found inside of /ccmspre/config_original.php and /ccmspre/user_whiteList_original.php as required.
  • Copy and or Rename /ccmspre/config_original.php to /ccmspre/config.php and /ccmspre/user_whiteList_original.php to /ccmspre/user_whiteList.php.
  • Open a browser and call your test environment, if the first template that comes up says 'Custodian CMS Configuration Instructions' follow the instructions and double check your installation. Most likely you forgot to rename the /ccmspre/config_original.php and /ccmspre/user_whiteList_original.php files described above.

CCMS project website: https://custodiancms.org (Under development)