A Simple To Use Template For Blog Style Websites!
My Website Uses This Template: https://www.rianbergen.com/
- This site requires that you have a webserver capable of running at least:
- HTML 5, CSS 3, JS 5, PHP 7.3, MYSQL 5.5.60
- We use TinyMCE for any Edit Fields within the Admin Panel. You will need an API Key which you can get here:
- We use HashOver for any comments/discussions on the site. You can visit their site here:
- Download the latest Source Code, or, download the latest stable release from GitHub.
- Copy and Paste all of the Source Files into your Website wwwroot folder. If done correctly, the
.htaccess
file will end up in the wwwroot folder. - Open up the
.htaccess
file and change all of the following:- Change every instance of
YOURDOMAIN
with your domain name. Example: My domain name is rianbergen, so, I will changeYOURDOMAIN
withrianbergen
. - If you do not have an
https
certificate, replace every instance ofhttps
withhttp
. If you do have an https certificate, please ignore this step. - If you do not have
.com
as your top-level domain, replace every instance of.com
with your top-level domain. Examples:.net
,.org
,.gov
, etc.
- Change every instance of
- Open up the
404.html
and500.html
files and change all of the following:- Change every instance of
YOURDOMAIN
with your domain name. Example: My domain name is rianbergen, so, I will changeYOURDOMAIN
withrianbergen
. There is one instance ofYOURDOMAIN
in the html title. I changed that toRian Bergen
instead. - If you do not have an
https
certificate, replace every instance ofhttps
withhttp
. If you do have an https certificate, please ignore this step. - If you do not have
.com
as your top-level domain, replace every instance of.com
with your top-level domain. Examples:.net
,.org
,.gov
, etc.
- Change every instance of
- Download the latest binaries folder from the latest stable release on GitHub. This will contain a SQL Database File that needs to be imported to your website.
- Navigate to the following folder
\wwwroot\includes\credentials\
and open up thecredentials.php
file. This file contains all of the global site variables including your SQL Database Credentials (for #4 above) as well as the site dependency credentials.- Change every instance of
YOURDOMAIN
with your domain name. Example: My domain name is rianbergen, so, I will changeYOURDOMAIN
withrianbergen
. - Change
hostname
,port
,database
,user
, andpassword
to your SQL Database Credentials. - Change
key
to your TinyMCE Link. It should look something like: https://cloud.tinymce.com/5/tinymce.min.js?apiKey=000000000000000000000000000000000000000000000000 - Change
absolute
to your website's absolute URL. - If you change CSS files, please make sure to update the CSS Version to a new number. This bypasses any cached files someone may have.
- Change
title
anddescription
(under the HTML Values Section) to the html title and description that you want. - Change
title
,description
,copyright
(under the Titlebar Values Section).title
refers to the Header and Footer Title Bar.description
refers to the descirption underneath the Header Title Bar.copyright
is displayed at the bottom of the page. - Change
email-address@email.com
andadmin name
to your admin information. This address will recieve emails concerning Comments, Subscribe/Unsubscribe, and Contact Requests.
- Change every instance of
- HashOver also keeps a file containing Credentials. This file can we found in
\wwwroot\hashover\backend\classes\secrets.php
- You can find more information at: https://docs.barkdull.org/hashover-v2/setup#required-setup/
- It will also require you to make a second sql database. This database can be empty as HashOver will fill it out on startup.
- To install your own images, please go to the following folder
\wwwroot\_res\images\icon
and follow the instructions below.- There are 3 logos within this folder. Please replace those with your own. They should be the exact same sizes and should be named exactly the same. These images appear in the title bar of your browser.
- If the installation went correctly, you should see an Under Maintenance Post on your homepage.
- Going to www.YOUDOMAIN.com/admin (please replace YOURDOMAIN with your actual domain), will bring you to the Admin Panel Login.
- Username: Admin
- Password: Admin
- Once Logged In, I recommend that you immediately go to
Users
.- Click the
Edit
Action for the Admin User. - Change the
Username
,Password
, andEmail
to make sure that your Admin Panel is secure. Make sure to choose a strong password that you can easily remember. ClickUpdate User
once you are done.
- Click the
- After this, I recommend clicking
Pages
. Here you will find all of the Website Specific Pages and the Content that shows up on those pages. I recommend going through each one of them by clickingEdit
and modifying the content to your liking. - To change the About You Image, go to Admin Panel/Images and upload an image of your choosing. You should then be able to go to Admin Panel/Pages/About and change the Banner Image.
- When posting issues:
- Please describe the issue/feature request as best as possible including steps to reproduce. Please also include code samples if possible
- Please use the appropriate labels for your issue.
- If it is a bug, use
Bug
. - If you think it is a bug but aren’t sure, please use
Possible Bug
. - If it is a question, please use
Question
. - If it is a possible improvement to an existing feature, please use
Improvement
. - For new feature requests, please use
Feature
.
- If it is a bug, use
- Committing Code:
- Please Fork the Repository before making any commits.
- Please make commits to the Development Branch.
- Once done, please put in a Pull Request and a moderator will check it out.
- Please describe in the commits and pull requests what it is you are changing/fixing.
- Gerrit Bergen:
- Website: https://www.gerritbergen.com/
- GitHub: https://github.com/GerritBergen
- For helping solve some of the issues and providing at least 30% of the inspiration!
- David Carr
- Website: https://dcblog.dev/
- GitHub: https://github.com/dcblogdev
- He has some very helpful tutorials on his website as well as some amazing code examples!
- TinyMCE
- Website: https://www.tiny.cloud/
- They provide the edit fields used within the Admin Panel.
- HashOver
- Website: https://www.barkdull.org/software/hashover/
- They provide the Comments/Discussion capabilities needed.
Copyright (c) 2019-2021 Rian-Pascal Bergen (TM)(C)(All Rights Reserved) (https://www.rianbergen.com/)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.