/yii2-mylib

my book library app

Primary LanguagePHP

Build Status Code Climate Test Coverage Yii2

commits

  • [skip ci] - skips travis ci builds
  • [sc] - skips sending clover report to codeclimate

About MyLib

It is book library manager written in PHP based on JqueryUI for personal usage. Main purpose is to manage own book library as excel table with ratings and other stuff like filename syncronizations of your books and more. Said that, it supports all JQuery UI themes.

Most js/css come from CDN networks, so you probably eager to check code at /app/assets/*

Requirements

  • php >=5.5
  • url rewrite
  • mysqlite or mysql

Setup

composer create-project  yurii-github/yii2-mylib  --stability=dev --no-dev

remove --no-dev to get dev required stuff

entry point is located at

PROJECT/app/public/index.php

Functionality

  • excel table is sortable, pagable
  • books CRUD
  • book cover saved to database
  • themed (JqueryUI)
  • i18n
  • mysql and sqlite support
  • syncronization with filesystem (renames, deletes)
  • migrations
  • security (partial)

TODO

  • admin page. base
  • true authors, publishers, categories
  • in sqlite run VACUUM for space saving
  • CDN fallbacks
  • user tests

Usage

As app is not truly finished, some workarounds must be considered.

Add New Books

The simplest way is to drop your book(s) to lib folder you've set in configuration and seconds tab "syncronization" press "import fs only". It will import all file system books that are not in database yet.

Edit Books

You can edit book at frontpage excel sheet. If you enabled sync, app will require write permissions on your books to rename them accordinly to your book name format (supported tags are limited to {year}, {title}, {publisher}, {author}, {isbn13}, {ext}). Don't forget, that during import app doesn't recognize extension, it adds whole import name into title, so you have to add extension manually to rename file properly. NOTE! If you change book name format it will not rename all books! App will apply new format only to newly renamed books by you

Remove Book

To remove book from lib just click trash icon near book. If you enabled sync, it will remove this book also from file system.

Configuration

Email is not functioning. I still think about its value Security is not implemented for real. low importance Other things work as expected. A big note requires filesystem encoding. This is a must for file sync. In Windows this is mostly cp1251 codepage.

last check true check: 28-10-2015