Localular
A modern theme for your Apache localhost directory.
Description
Localular is a modern theme built with AngularJS, PHP, HTML5, CSS3, and jQuery to enhance the experience of browsing your Apache localhost web directory on a Mac.
Requirements:
- macOS Sierra
- User level root web directory (i.e. Sites folder)
- PHP >= v5.6.30
- Apache >= v2.4.25
- A sense of humor
Installation
- Download the repository.
- If needed rename the name of the folder to
localular
. - Move the
index.php
andhtaccess.txt
files from inside thelocalular
folder to your user level root web directory, which is theSites
folder. - Rename the
htaccess.txt
file to.htaccess
. - Now, move the
localular
folder to yourSites folder
. - Restart Apache in your terminal:
sudo apachectl restart
Additionally, for all sub-directories to use the Localular theme, you need to copy and paste both the index.php
file and the localular
folder in the root of each sub-directory.
Features
Responsive modern aesthetics
Icons by file type
Search directory
Directory count
Sort by date or name
List PHP, MySQL, and Apache version
Link to phpMyAdmin
Best of all it’s free!
Screenshots
Troubleshooting
In my vhosts
file, which is located at: /etc/apache2/extra/httpd-vhosts.conf
, I have the following config setting for my user level root web directory (username
will obviously need to be your username on the machine) :
<Directory "/Users/username/Sites">
DirectoryIndex index.php index.cfm index.html index.htm
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Require all granted
#Custom directory listing
IndexOptions +SuppressHTMLPreamble
AddType text/html .php
Addhandler application/x-httpd-php .php
</Directory>
To Do List
- Add a return to parent directory link if using theme in sub-directory
- Expand on the icon feature set and active state
- Develop a seed/boilerplate for more efficient future customization
Resources
Inspiration
Localular was inspired by: Victor Camargo’s work on LocalTheme.
Changelog
1.0
- Start version.