sdebacker / typicms Goto Github PK

View Code? Open in Web Editor NEW

475.0 61.0 119.0 24.63 MB

Multilingual CMS built with Laravel 4.2

License: MIT License

PHP 84.05% JavaScript 4.40% CSS 0.01% HTML 0.11% Hack 2.61% Shell 0.02% Blade 7.08% Less 1.73%

cms laravel multilingual

typicms's Introduction

This repository is deprecated, please use the latest TypiCMS.

TypiCMS for Laravel 4.2

TypiCMS is a multilingual content management system built with Laravel 4.2. Bower and gulp are used for asset management and the user interface is built with Bootstrap 3 with Less.

Features
Requirements
Installation
Modules
- Pages
- Menus
- Projects
- Categories
- Tags
- Events
- News
- Contacts
- Partners
- Files
- Galleries
- Users and groups
- Blocks
- Translations
- Sitemap
- Settings
- History
Facades
Artisan commands
Roadmap
Contributing
Testing
Licence

Features

URLs

This kind of URLs are managed by the CMS:

Modules:

/en/events/slug-in-english
/fr/evenements/slug-en-francais

Pages:

/en/parent-pages-slug-en/subpage-slug-en/page-slug-en
/fr/parent-pages-slug-fr/subpage-slug-fr/page-slug-fr

Requirements

PHP >= 5.4.0
MCrypt PHP Extension
Memcached or Redis or APC

Installation

Quick installation

Install Node.js, Bower and gulp
Create an empty MySQL database

Create a new project

composer create-project sdebacker/typicms mywebsite

Enter the newly created folder
```
cd mywebsite
```
DB migration and seed, user creation, npm installation, bower installation and directory rights
```
php artisan typicms:install
```
Go to http://mywebsite.local/admin and log in.

Manual installation

Create an empty database

Download TypiCMS

git clone https://github.com/sdebacker/TypiCMS.git mywebsite

Enter the newly created folder
```
cd mywebsite
```
Install dependencies with Composer
```
composer install
```
Set a new encryption key
```
php artisan key:generate
```
Change the cache prefix in app/config/cache.php
```
php artisan cache:prefix yourCachePrefix
```
Rename .env.example to .env
```
mv .env.example .env
```
Fill in your database credentials in .env
Migrate and seed the database
```
php artisan migrate --seed
```

Set permissions

chmod -R 777 app/storage
chmod -R 777 public/uploads

Go to http://mywebsite.local/admin and log in:

email: [email protected]
password: admin

Bower & Gulp

In order to work on assets, you need to install Node.js, Bower and gulp, then cd to your website folder and run these commands:

Install bower packages according to bower.json (directory app/assets/components)
```
bower install
```
Install gulp packages according to gulpfile.js (directory node_modules)
```
npm install
```
Compile admin and public assets
```
gulp
```

Configuration

Set available locales and the default locale in app/config/app.php
Cache driver is set to memcached. You can change it to another taggable cache system such as redis in app/config/cache.php

Modules

Pages

Pages are nestable with drag and drop, on drop, URIs are generated and saved in the database. A page has routes for each translation.

Menus

Each menu has nestable entries. One entry can be linked to a module, page, URI or URL. You can get a HTML formated menu with Menus::build('menuname'). An icon can easily be added to a menu item by filling the icon class field.

Projects

Projects have categories, projects URLs follows this pattern: /en/projects/category-slug/project-slug

Events

Events have starting and ending dates.

News

Simple news module with linked files/images galleries.

Contacts

Frontend contact form and admin side records management.

Partners

A partner has a logo, website URL, title and body content.

Files

The files module allows you to upload multiple files. It uses DropzoneJS to upload them. Thumbnails are generated on the fly with Croppa.

Galleries

You can create as many galleries as you want, each gallery has many files. Galleries are linkable to any module item through a polymorphic many to many relation, for now only the news module is properly set up to support galleries.

Users and groups

Sentry 2 is used to manage users, groups and permissions. User registration can be enabled through the settings panel (/admin/settings).

Blocks

Blocks are useful to display custom content in your views. You can get the content of a block with Blocks::build('blockname').

Translations

Translations can be stored in the database through the admin panel (/admin/translations).

You can call DB translation everywhere with Lang::get('db.Key'), trans('db.Key') or @lang('db.Key').

Sitemap

Route sitemap.xml generates a sitemap file in XML format. To add modules to the site map configure app/config/sitemap.php.

Settings

Change website title, and other options trough the settings panel. Settings are saved in the database.

History

History table records changes and 25 latest records are displayed in the back office’s dashboard. Logged actions are created, updated, deleted, set online and set offline. It works for all modules except users and groups.

Facades

Modules that have their own Facade: News, Events, Projects, Places, Partners, Galleries, Blocks, Files and Menus.

In your views, you can call for example News::latest(3) to get the three latest news. Check available methods in each module's repository.

Artisan commands

Commands are located in app/TypiCMS/Commands

Initialisation of TypiCMS
```
php artisan typicms:install
```
Set cache key prefix in app/config/cache.php
```
php artisan cache:prefix yourCachePrefix
```
Initial migration and seed
```
php artisan typicms:database
```

Roadmap

Improve user interface
Implement modules as packages
Build more tests

Contributing

Feel free to fork and make pull requests directly on the master branch! TypiCMS follows the PSR-2 standard.

Thanks to elvendor and jekjek for their contributions!

Testing

Some admin controllers are actually tested, more tests needed.

License

TypiCMS is an open-source software licensed under the MIT license.

typicms's People

Contributors

Stargazers

Watchers

Forkers

jekjek changwuf31 imanifaiz albersmc ahzab movibe blitzkrieg1 karkoonzaid elvendor 2bj cw-oldrepos sd031 z115corporation burakoztirpan fernandoalves-ink mpandar markandrewj heavenmirror puralogica n0c0py89 fhferreira henrydewa devypt crny xtwoend tangoun danielczestki mkapinos deyvi-james alpar yayann torome mrakodol mrkodssldrf young91 whsheng junfengwu graovic dungphan307 wolftungvn agenge lukeddy no2key jurogn immarsyang jeremykenedy lneicelis tolotraram alexliu-1990 dam1r89 ivanmijatovic89 grahamne imuller megat136 leolujuyi allan-empalmado illuminate3 brucewu16899 jeanco song-yuan trippo linuxwit russjohnson09 xemmexservices alexrobinson- mermalrain mohamedsharaf caoluc evervasquez kamekun manuelramireztech zxgrand projectarchives phpframewrok minetvn lysleung uuking micie phpsong ccarafa sachintaware gopain mnek84 jinguoxing popohum sunwy0726 k1fathi mk0827 josephmario lengpiseth jadulled omusico yaoshanliang totoyy shenzhenlong1203 xuanxu11 arshiyan baitongda brycehappy rennyrocha

typicms's Issues

FatalErrorException when delete partner

Hello,
I'm getting FatalErrorException in file TypiCMS/Repositories/RepositoriesAbstract.php with message "Call to a member function each() on a non-object" when I try to remove created Partner.

Upgrade to Laravel 4.2.*

There are many improvements in version 4.2.1 of Laravel framework, but current version of TypiCMS doesn't work with it, many of vendors didn't upgraded to 4.2 yet. We have to wait I guess.
BTW, this issue also needs to be in 2.0 milestone.

Add possibility to build a unilingual website without lang in url

Adding a field to settings form template and then submit returns Exception

Make a DB backup and restore system

Issue with the select picture

When I try to insert a picture to the TinyMCE I get the uploader page.
Sorry, I don't have enough skills yet to point out how to fix the problem.

On page edit/create, add an option to generate a menu item in a specific menu.

Installer interface for first admin user creation

Build a RESTful API

Possible bug: same slug, different categories

In Projects Module I get project by its category & slug, but if I change the category to the another existing one, I get the same project.
Example:
http://typicms/en/projects/logos/apple_com & http://typicms/en/projects/companies/apple_com are the same project.

Dynamically set validation rules for translated fields

Export an event to iCal file

Bug: incorrect links in switch lang on public projects page

I'm getting http://localhost/en/projects/%7Bcategories%7D/%7Bslug%7D URI when I try to switch language on some opened project page.

How to add own route

Hello! I want to add my route without any controller or module, just want run a Closure in route, for example '/currency/usd'. As I can see in code, every request that is not 'admin' processed by Pages module, and even when add my route to app/routes.php file, my request ends up with 404, because I don't have page with that route name.

Any ideas how to deal with that? Thanks in advance

Cache bug on gallery editing

When editing a gallery, cache from modules where this gallery is attached to must be flushed.

Enhance multi-lingual backend

Use of block module for welcome message
Use of Menu module for menus in backend

Offline Menu stays visible on public side

Set resource online/offline via switch cause some strange behaviour

Side menu of children pages should be in a partial template

SQL optimization for menus

All public side menus should be loaded in one query.

Proposal: keep Modules settings in app/config/modules.php file

Keeping things simple is a great way to learn how CMS works for a new developers I guess.

Artisan install command

Build artisan command to

chmod app/storage and public/uploads;
migrate DB;
change cache prefix;
generate Encryption Key;
npm and Bower install.

Validation problem with checkboxes

Missing pagination in Project module

Error installing typi

I get this when I run composer install:

Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file
Nothing to install or update
Generating autoload files
Generating optimized class loader
Compiling common classes



  [ErrorException]                       
  Undefined variable: undefinedVariable  



optimize [--force] [--psr]


Script php artisan optimize handling the post-install-cmd event returned with an error



  [RuntimeException]                         
  Error Output:                              


    [ErrorException]                         
    Undefined variable: undefinedVariable    



  optimize [--force] [--psr]

AbstractRepository->getAllBy more than one 'where'

I needed more than one condition in getAllBy method and I made changes like this:

public function getAllBy(array $conditions = array(), array $with = array('translations'), $all = false)
{
  $query = $this->make($with);
  if (! $all) {
    // Take only online and translated items
    $query = $query->whereHasOnlineTranslation();
  }
  if(is_array($conditions) && count($conditions))
  {
    foreach($conditions as $key => $value)
    {
      $query->where($key, $value);
    }
  }
  $models = $query->get();
  return $models;
}

And then in any Controller:

$conditions = array(
  'category_id' => $category->id,
  'type' => $type
);
$data = $this->repository->getAllBy($conditions, $relatedModels, false);

What do you think about this?

Missing translation on group update

Replace a file should delete previous file from file system

Add RSS to news module

Backend: Edit button on images in galleries module

Symfony \ Component \ Debug \ Exception \ FatalErrorException Class 'Memcached' not found

Suggestions: use reverse migrations & seeding

What do you think about reversing database structures back to migrations and make repopulate seed files whenever you added something to the website?

Please, look at these package, you'll understand what I mean:

https://github.com/XCMer/larry-four-generator
https://github.com/orangehill/iseed

You can add new functionality to Settings module right near DB Dump and Clear Cache.

Also it would be great to store db backups by dates and restore from web interface.
And last suggestion is running db backups with cron, by adding https://github.com/indatus/dispatcher.