sWADAH

Perpustakaan Tuanku Bainun

Introduction

sWADAH is Malaysian-made Digital Institutional Repository (DIR) system that are easy to use and configure.

Development

The development of this DIR begun in 2009 started from our iSYS engine. During this 10 years, we spent countless hours developing our own DIR to support all the newest technology made possible in the software development community. This is mainly because Eprints and DSpace are not so easy to use and complicated to install.

Developed entirely using PHP7, HTML, Javascript and MariaDB, sWADAH codes were easy to understand even those who had minimal knowledge of programming. User can easily fork their own version of sWADAH and customize endlessly.

Technology

Main ingredients: PHP7, HTML, CSS, Javascript, MariaDB

Added recipes: jQuery, jQueryUI, fontawesome, tinyMCE, pdf.js, parsley, phpmailer, smalot/pdfparser, pdftotext

Features

  1. Input using MARC record
  2. UTF8 Unicode
  3. Google Scholar metadata indexing
  4. OAI-PMH v2.0
  5. PDF word-by-word indexer
  6. White-listed IP support
  7. Guest PDF support
  8. Duplicate Finder Tool
  9. Easy to rebrand, backup, restore, configure
  10. Admin/User account portal
  11. Mobile app
  12. User self deposit with submission-approval and email notifications subsystem.
  13. Reporting tools for various aspect of system administration and usage.
  14. Eprint import tool (beta)

Upcoming Features

  1. Librarian view
  2. Photo/Picture deposit with auto-watermark
  3. uketd_dc support for OAI-PMH v2.0

Installation Note

Follow this instructions (localhost environment) or watch this installation video (in Bahasa Melayu):

  1. sWADAH may require this php add-ons:
    php-common, php-mysql, php-gd, php-xml, php-mbstring, php-mcrypt

  2. Download installation files of sWADAH (sWADAH_<build>_files_install.zip) and its database (sWADAH_<build>_database_install.sql)

  3. Create new database using your method of choice (eg. phpMyAdmin, mysqldump) and import the sWADAH_<build>_database_install.sql into the database you have created.

  4. Next, extract sWADAH_<build>_files_install.zip into your web server working directory (eg. Centos: /var/www/html)

  5. Next, you will need to setup config.php inside the extracted web server directory above. Follow the documentation inside the file to configure your database, upload directories and many other settings.

  6. To check if your installation is successful, try accessing index.php (eg. http://localhost/swadah/index.php if extracted in swadah directory in the web server)

  7. If your configuration succeed, you may see this screen:



  8. Default login password for admin is 1. You’ll need to change this password as soon as possible.

  9. Optional step: Newer version of sWADAH (beginning 2020X) require composer to be install alongside with smalot/pdfparser that needs to be updated. Refer https://github.com/smalot/pdfparser for more info now how to install. This is optional and disable by default, but sWADAH will use pdftotext module to read PDF contents.

Upgrading Note

Upgrading is easy. You will need to download (sWADAH_<build>_files_update.zip) and its database (sWADAH_<build>_database_update.sql –if available)

Then extract the zip file to overwrite contents on your installation directory. If the database_update file is available, simply import the script using phpmyadmin or any mariadb/mysql database management software.

Please take note that config.php will be overwritten. Please make use of config.user.php (more on config.php and config.user.php below)

Understanding config.php

config.php is central file for accessing and editing sWADAH configurations. Click here to view documentation of config.php file or view this explanation video on YouTube (Bahasa Melayu).

Understanding config.user.php

You may create config.user.php that will exist alongside with config.php. After creating the file, you will need to uncomment

include (‘config.user.php’) in config.php file

in order for sWADAH to fetch it configuration properties from the file.

You may assign your own values (all attributes and initial values can be refer back in config.php) so that when you are upgrading sWADAH, your configuration will remain. If you do not have this file, you have to start over. So the existence of config.user.php is to facilitate easy upgrading if ever config.php will change in the future releases. All values assigned in config.user.php will overwrite the one in config.php

For more information, you might want to see this explanation video on YouTube.

Download Releases

Click here to view up-to-date releases.

Contact Us

If you requires additional helps or need information regarding the installation of sWADAH, contact us at asyrani@upsi.edu.my

We are also providing PRO PACKAGE for any potential clients. PRO PACKAGE includes:

  • 1 year priority bug-fixes
  • Training for customization and administration
  • Backup automation to your cloud storage
  • Mobile app (Android only)

Brochure

Screenshots