Notice

This is a WIP Progress Repo and not ready for Production uses yet.

Intial Setup

Native

1. Install PHP with minimum version of 8.2. If you cannot get PHP 8.2 on your machine consider using docker or another container solution.
2. Enable php extensions curl, iconv, mysqli, pdo_mysql, zip
3. Install Composer
4. Run composer install
5. Install npm
6. Run npm install && npm run build to install the necessary packages and prepare the javascript and css
7. Setup the require .env variables following Laravel Installation Documenation
8. To run locally for development use php artisan serve

Docker / Sail

1. Install docker and docker-compose
2. Setup the require .env variables following Laravel Installation Documenation
3. If you want to use sail then follow Laravel Sail Documentation skip the dev install step (it is already installed)
4. If you want to use base docker then you will need to setup your own docker compose file as of now a supported configuration is in the works.

Integrating with Current Symbiota

1. Copy or Clone BioKIC/Symbiota into repo
2. Add PORTAL_NAME= to your .env file and give it the name of the folder you just created
3. Setup the rest of the .env to connect DB secrets to match your symbiota config
4. Test by Navigating to a no laravel page like sitemap on the navbar

Note: Moving portal into Laravel's public folder will not make use of any of laravel's features. This step is just a means to slowly port the project in a non blocking fashion.

Pages Running Laravel

Occurrence

• Profile
• Editor
• List Results
• Table Results

Collections

• Profile
• Permissions
• comments
• loans
• Specimen Labels
• Annotation Labels
• Batch Georef Tool
• Batch Determinations
• Darwin Core Archive Publishing
• Duplicate Manager
• Cleaning Tools
• Backup Download
• Resore Backup
• Thumbnail Maintenance
• Update Stats
• Editor
• Table Editor
• Specprocessor
  • Image Loading
  • Crowdsourcing
  • OCR
  • Reports
  • Exporter
  • GeoLocate

Upload

• Base Page
• Full Text File
• Skeletal File
• Darwin Core Archive Manual
• IPT Resource / Darwin Core Archive Provider
• NfN File
• Direct Database Mapping

Download

• Base Page UI
• Symbiota Schema
• Darwin Core Schema

Media

• Profile
• Edit
• Search
• Creator Lookup

Taxonomy

• Profile
• Editor
• Tree Explorer

User

• Login
• Registration
• 2auth
• Oauth (Orcid)

Checklist

• Profile
• Admin Editor
• Voucher Editor

Maps

• Coordinate Aid
• Point Aid
• Occurrence | checklist Search
• Checklist/Profject map
• Taxon Thumbnail Generator

Misc

• Sitemap
• Datausage