Buzzy Documentation Current version 1.3.2

Server Requirements

Checking to ensure that your web host have the minimum requirements to run Buzzy.

  1. PHP >= 5.5.9
  2. PDO PHP Extension
  3. OpenSSL PHP Extension
  4. Mbstring PHP Extension
  5. Tokenizer PHP Extension
  6. GD PHP Extension
  7. Fileinfo PHP Extension
  8. Zip PHP Extension

Please download "check.php" file and check your web host minimum requirements to run Buzzy with below button.

Download Check.php file!

Installing Buzzy

The following quick steps show how the installation progress.

Step 1 - Unzip and Upload

Extract and copy the files from the archive you have downloaded from CodeCanyon to your server. Make sure you have all files on your server when you have done with upload


Step 2 - Open Installation Wizard

If you have all requirements on your server so system will redirect you to install page. If install page did not show up and your getting some errors on your screen then please check FAQ tab and find your answer.


Step 3 - Installation Wizard Steps

  1. First step checking requirements
    All requirements must be green. If you have red with one of them. Please check that page on your cpanel (You can find that options on Select Php Version ). If you did not find any configuration about that. Please contact with your provider.

  2. Next step, Checking your Buzzy Access. Please click "GET Buzzy Code" button and add your envato purchase code and domain name and take the Buzzy access code and check your Buzzy access code on that page.

  3. On this step, Our installer will check of permissions of directories. If any listed folder is not writable. Please make writable and go to next

  4. Final step, you need to type your database details for creating database.

    Host= Usualy It should be "localhost"
    Database= Database name you created
    Username= Mysql server login username
    Password= Mysql server login password
    Okay, If you type all fields then go finish your installation.
    If you have issue on this step: Please check FAQ tab and find open_basedir or escapeshellarg() section

  5. That is it! All the necessary things automatically created by the wizard. Now you can exit the wizard and follow the introductions for admin panel.

When your installation is complete, it’s time to configure Buzzy.

To set the site name, logo etc. go to Admin > Setting > General Settings.

Main Configuration

Following informations needed to be updated.
  • Site name - Your site name
  • Site Logo - Pick a png logo.
  • Site Favicon - Favicons like site icon. Pick a png icon
  • Site Default Meta Title - This is important for search engines. Type something about your site.
  • Site Default Meta Description - Same as title. Type some detail about your site.
  • Terms of Use Page Url - This is uses by register form. You can create page for this. Check how to add new page here.
  • Site email - When we send email that email shown to user.

Advanced Configuration

  • Head Code - You can put there custom css or meta tag code etc.
  • Footer code - You can put there custom js or google Analytics code etc.

You can also configure Layout, Social Media Addresses in here. Just read the introductions below the inputs.

Following informations uses by logining. You can get api keys from the following social media sites.

Facebook

  • Please check official docs from Facebook: https://developers.facebook.com/docs/apps/register
  • See example facebook app details on SS1,SS2, SS3, SS4
  • When you have done with all steps you can get access token and secret. Type those to Buzzy Admin Panel > Settings > General settings > Login Configuration Facebook app

Buzzy Facebook App Callback Url: http://your-site-name.com/auth/social/facebook/callback

Twitter

  • For getting app from the Twitter is easy. Just checkout following article: http://iag.me/socialmedia/how-to-create-a-twitter-app-in-8-easy-steps/
  • When you have done with all steps you can get access token and secret. Type those to Buzzy Admin Panel > Settings > General settings > Login Configuration Twitter app

Buzzy Twitter App Callback Url: http://your-site-name.com/auth/social/twitter/callback

Reminder!

If you get error We cant get your email address! Please register with your email address. on your Buzzy Twitter logining.
You must type your Privacy Policy URL and Terms of Service URL and App Logo. See Full Twitter App Settings.
Then must check "Request email addresses from users" checkbox on your Twitter App permission tab. See Full Twitter Permission Settings.

Reminder2!

If you have not Privacy Policy URL and Terms of Service URL or permission tab.
Then you need get app permission from Twitter. Twitter does not share emails with apps as default.
Please read "Request a User’s Email Address": https://dev.twitter.com/rest/reference/get/account/verify_credentials

Google

See Full Google App Settings.

Buzzy Google App Callback Url: http://your-site-name.com/auth/social/google/callback

Categories provide a helpful way to group related posts together, and to quickly tell readers what a post is about. Categories also make it easier for people to find your content.

Adding Categories

You can add new categories and manage existing ones from Admin -> Categories.
  • You will be presented with a list of your existing categories and an option to add new categories.
  • You can add a new category by filling out the fields:
    • Category name – As expected, the name of your category.
    • Description – Describe what the category is for. This description will appear as a tooltip if you use the category widget. (Optional)
    • Category Type – Select the parent type in here. This mean this category will only take that contents and listed on only that create page.

    Tip!

    You can add same name of category for other content types. For Example: Category name: Funny may be added both type as List or Videos etc..

Managing Categories

You can edit or delete categories.
If you click on Edit you will taken to where you can edit the name and description. This functions exactly the same as adding a category.

Clicking on Delete will delete that category. When a category is deleted, all posts that were only in that category will be assigned to the top category.

Buzzy comes with 4 post types. News, Lists, Polls and Videos.
You can manage all of these contents on the admin panel.

Managing Posts

When you go inside the posts pages on the panel, you will see actions appear on the last table column.
You can Review, Edit, Approve/Unapprove, Send to Trash/Retrieve from Trash and Permanently Delete posts with those links.
You also have the access to choose the posts for the homepage and featured posts area.
  • Review
    When you click the post title on the list You will be redirected to the post page in the site.
  • Editing
    If you click edit you will taken to where you can edit the post on the site. This functions exactly the same as adding a posts. You have access to edit all users posts.
  • Approve/Unapprove
    Approve to publish the post, Unapprove to mark as pending to posts.
  • Send to Trash/Retrieve from Trash
    You can soft delete posts. Those posts are listed one the panel post trash lists. Also if you want to retrieve posts from trash. You can do that to.
  • Permanently Delete
    As expected, the posts will delete permanently with entire entries and images etc.
  • Choose for Homepage
    Posts can be select for homepage. Selected posts will be display on the homepage.

    Reminder!

    This action only works when you select DISABLE for "Auto-listed on Homepage" option. You can find that configuration on the Admin > Settings > Other Settings

  • Featured Posts
    All featured post are shown on the homepage top and also category pages.
    You must choose the posts for the featured areas.
    TIP: You must also select "Choose for homepage" for displaying featured posts on the homepage.
    Features posts are ordered by featured dates. First four posts shown on the category page.
    Also First four selected for homepage posts show up on the Homepage.
    This mean when you choose a post for featured it's not appear the homepage top.
    It's only shown cagetory page. When you also choose "Choose for homepage". Post will show up homepage top.
    Lastly, homepage featured posts should be chosen for featured and homepage.

Buzzy comes with powerful user post editor.
With BuzzyEditor users can add their news, lists, polls and videos.

Creating Posts

When you open the create page of news, lists, polls or videos. You will see all available inputs.
  • Title
    Required and must be min 10 / max 255 character.
  • Description
    Also required. Must be min 10 / max 500 character.
  • Preview Image
    Required and for best results must be 650x350 pixels.
  • Categories
    All available categories are listed here. See how you can add more categories in here.
  • Entries
    Entries are most important things on the editor. It's simpley where you can build your posts.
    All different posts types has their entry types.
    • News can have Text, Image, Video, Iframe Entries.
    • Lists same as news but you can order them asc or desc style.
    • Polls can have only Option entry.
    • Videos can have Video, Text, Embeds

    Adding New Entry

    • Texts mostly for News. You can add large text with this.
    • Image Adding new image is easy. Just click to pick a image and choose image from your computer. This entry great for lists. You can also add title, source of image and some text details of image.
    • Video For adding video, paste url to video. Supported sites: youtube, dailymotion, vimeo.
    • Iframe If you want to any video embed or Instagram embed, Tweet embed etc. You can use this entry.
    • Option entry for polls. You can add max 255 character option here.

Buzzy owners have full control to users, user information.

User Editing

You can review and edit user account information in User Settings. To do that click the Edit link in the Actions in the list of Admin > Users.
  • Username – Usernames must be unique. You can change user username by typing in a new one into the username field and following the instructions that appear.User usernames will display next to any posts user make in the Buzzy Script.
  • Email Address – Required. One email address cannot be registered with multiple accounts.
  • Password – Admins and users can change this.
  • User Details – All other user details are changeable.

Ban User

To ban someone click the Lock User in the Actions in the list of users.

Make User an Administrator

An Administrator has full power over the site and can do absolutely everything. Administrators can create more Administrators. And Complete control over posts, settings, pages, users and the whole site. Nothing is off-limits for Administrators.
To make someone an admin click the Make Admin in the Actions on the list of users.

Also you can set user permissions. For this please check Admin > Other Settings > User Permissions

Pages are static. That means that the information displayed on a page doesn’t change, or doesn’t change often. A great example of a page would be the Terms or About or Contact Us section of a website.

Create a New Page

To add a new page, navigate to Admin > Pages, then click Add Pages: You’ll land on the Page form, where you can add text, media, embeds, or any other content for your page. Publish your new page when you have done.

  • Title – As expected, the title of your page. This is also used by title meta tag.
  • Title Slug – This is url to where you can access your page.
  • Description – This is short description of your page. uses by meta tag.
  • Text – All content of your page goes here.

Removing Pages

You may want to delete some of your pages. To do that click the Delete link in the Actions on the list of pages.

Widgets are a great way to customize the sidebars (and other special widget-ready areas) of your site.

You can access your widgets from the Admin > Widgets.

Adding and Configuring Widgets

To add a widget, In the right widgets form show all of the available widgets areas that you can add.

  • Widget Name – As expected, the name of your widget.
  • Content – This is where you can put your custom html widget contents.
  • Location – This is show all of the available widgets areas that you can add. Select the widget location in here..
  • Display – Widgets can be configured to visibility.

Removing Widgets

If you would like to remove a widget, click the Delete link in the configuration options in the list of widgets.

Using exiting langauge support of Buzzy

Buzzy has En, Tr, Ru, It, Es support out of box. Just You can use with one quick step
  • Open Config Folder > app.php and find 'locale' => 'en' line and type what you have want.

Create your langauge support

Do you want to use your Buzzy in your Languages? With few quick steps you can set up your site with your language.
You can translate the Buzzy into your native language following steps.
We need to edit some files of course.

  • Just find lang folder in the resources directory and go inside to lang folder.
  • Copy "en" folder and paste with your language name (e.g. French can be named "fr", German can be named "de".).
  • When you do that your language folder is ready. Go inside that and translate all files with your favourite text editor.
  • If you finish translate all available files. You can define your language to Buzzy.
  • Open Config Folder > app.php and find 'locale' => 'en' line and type what you have create.
That's it. Simple 4 steps makes your site in your language.

Footer Multilingual Support

  • Please open app.php in config folder.
  • See there is language settings.
  • You can manage language on there. If you want use only specific languages please make sure you have only you want like this
  • If you don't want footer multilingual support then remove all language strings on there
    You will only get default one(what you select on 'locale' => 'en', ) if you leave empty this.
  • Finally
    rtl - Set true for Right-to-Left Support

    wideheader - Some languages require more width for menus. Set true if language broke menus.

We need mail configuration for registration, password reset system or post approve reminder email for post owner etc.

How can I create email on my Cpanel?

Please open your cpanel and find Email accounts option on there
And create your email address
Now you have mail address. Please click more button and click Configure Email Settings option.
In this page you will get this information. Get your mail server info and port there too.
That's it. Please open your env file on your Buzzy main directory. (Please check "I did not find my .env file!" on FAQ tab if you didn't find your env file)

Here's the final results must be like this
MAIL_DRIVER=smtp
MAIL_HOST=mail.buzzy.com
MAIL_PORT=25
MAIL_USERNAME=info@buzzy.com
MAIL_PASSWORD=mail password
MAIL_ENCRYPTION=
If you have problem with mailing with this setup then please contact your provider and get help from them.

You can use Gmail SMTP service too. Use like this;
MAIL_DRIVER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your gmail address
MAIL_PASSWORD=your gmail password
MAIL_ENCRYPTION=tls
If you have problem with mailing with gmail setup then please try to get Google app password and use that password as your gmail password on MAIL_PASSWORD variable:
https://security.google.com/settings/security/apppasswords

With Buzzy 1.3.1 update allows us to upload posts images and member avatars/splash images to Amazon CDN Storage.
This is useful for more free space on your server / host.

AWS S3 env file setup

You can find amazon api keys variables on your .env file in your Buzzy root directory. (If you was use Buzzy 1.3 so you need to add following variables as manually to env file.)
Here is the default variables We needs to set for AWS S3 support.
APP_FILESYSTEM=local
S3_KEY=
S3_SECRET=
S3_REGION=
S3_BUCKET=
  • APP_FILESYSTEM – It takes "s3" or "local". We need to set this as "s3". If you set this local. Images will upload to your server as default
  • S3_KEY – AWS key
  • S3_SECRET – AWS secret
  • S3_REGION – Your Bucket Region. Regions can be: us-east-1,us-west-1,us-west-2,eu-west-1,ap-southeast-1,ap-southeast-2,ap-northeast-1,sa-east-1,us-gov-west-1
  • S3_BUCKET – Your Bucket Name.
Here's the final results must be like this
APP_FILESYSTEM=s3
S3_KEY=AKIAIYH65T3HNWOUSOGQ
S3_SECRET=oEffpw8wsjkD5LoVdb/0eUvbYbFJO
S3_REGION=eu-central-1
S3_BUCKET=buzzy-bux-go

AWS Tutorials

Following links will show you how to create Aws account and S3 Bucket
Amazon Simple Storage Service
Access Denied Issue to files in an Amazon S3 Bucket

easyComment is a standalone php comment system. It's like Facebook Comment, Google Comment or Disqus Comment. easyComment actually works like one of those.

Buzzy with easyComment

Buzzy comes with Facebook Comments and Disqus Comments but also support our comments script called name easyComment

With easyComment plugin allows you and all buzzy users can write comments for the posts with their Buzzy accounts.
easyComment latest update gives us fully entegre comment system.
All Buzzy users can comment without second registration when you use easyComment.
  • Buy easyComment from Codecanyon here.
  • For installing easyComment, follow the instructions on the easyComment documentaion here.
  • We suggest you to install on subdomain like comments.yoursite.com. Upload your files to comments subdomain and point your browser to http://comments.yoursite.com/app/install.php.
    Then you can install easyComment with separate database with this install wizard.
    When you done with install. Then you can connect easyComment admin panel. Login and go settings > allowed domains section.
    Add your buzzy domain as yoursite.com and www.yoursite.com. Add both to per line
  • When you done with easyComment side. There's not much to do.
  • Just open your Buzzy Panel and enter the location where you install easyComment to initiation url field on the Buzzy admin panel > plugins > easyComment Plugin Settings. In our example initiation url must be this http://comments.yoursite.com/
  • That's it. Your easyComment works on Buzzy script just fine now!

Can I run on My Server?

If you have all requirements on your server then yes you can run!. Please check requirements Installation tab

Which Provider Do you recommend for Buzzy?

Buzzy will work any server if it match with our requiesment. However we suggest www.hawkhost.com, www.bluehost.com or www.godaddy.com hosting for Buzzy system. We have many successful installation on one of those

Can I use this in more than one domain?

First of all, please check Envato Help Page for it. http://codecanyon.net/licenses/standard With purchase license you have one domain permission. You need to get another licenses for your another domians if you want to use on more than one domain. Its same rule for any Codecanyon iitem.

Footer does not show up!

You need to add footer widget for it. Please check admin panel > widgets page.

My logo has not changed!

Please try to click f5 or clear your browser cache or try on another browser.

I did not find my .env file!

If you using file manager and did not see any file named .env. Then Please take a look that option on your filemanager login popup. Now you can see .env file . You can right-click and edit that file on there for some configurations like mail configuration

I see some errors on Quizzes Plugin page.

Please download Quizzes plugin files from Codecanyon and read read me file in it

My site turned right to left!

Please turn off rtl support on admin panel > other settings.

How can I use SSL!

Please add this to your your .htaccess file configuration
RewriteCond %{HTTPS} !=on
RewriteRule ^/?(.*) https://%{HTTP_HOST}%{REQUEST_URI} [R,L]


Full configuration must be Like this.
Options +FollowSymLinks
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^/?(.*) https://%{HTTP_HOST}%{REQUEST_URI} [R,L]
RewriteRule ^(.*)$ public/$1 [L]

How Can I change my files and theme!

Our theme files in resources/views, assets in public/assets folder. You can edit them.

My site layout turned right to left!

Please turn off rtl support on admin panel > other settings.

I need fresh install with my old data

Please install Buzzy with fresh files and new database. Then pleese move your old public/upload folder to new public/upload directory. and move your old database tables to new one

Issue: Parse error: syntax error, unexpected 'class' (T_CLASS), expecting > identifier (T_STRING) or variable (T_VARIABLE) or '{' or '$' in

It means you do not have PHP 5.5 or newer version. Buzzy needs PHP 5.5 / 5.6 or newer version.

Upgrade your Php
  • If you using Cpanel so you can find Select Php Version option on Php config section
    If you don't have that option on Cpanel then you need to contact with your provider. They disabled that option on your access
  • Current PHP version: must be 5.5 or 5.6 or 5.7. All good for Buzzy
  • And again make sure your extentions must be like this

Issue: I'm Getting 500 Server Error

It could be anything. Its a server error.

Possible solutions
  • Please first delete all Buzzy files and upload check.php (You can get check.php file on Installation tab). then point your url to www.yoursite.com/check.php and make sure you have all extensions we need.
  • Could be missing files.(Here is the full main folders and files you should get from CodeCanyon http://prntscr.com/9caxe3) Make sure you have all.
  • It may be permission issue too. If so please try to set 777 permission for storage and bootstrap folder and all folders and files on it.

Issue: is_executable(): open_basedir or escapeshellarg() has been disabled for security reasons

Your server configuration different then default settings. This is normal on shared hosting

How to fix it?
  • You need to create your database manually. Please download sql file here
  • Go to Cpanel > Phpmyadmin. Open your database and go to import tab. Select sql file you downloaded. Upload to you database
  • Than upload installed file to storage folder of Buzzy. That's it your site must be show up.

Issue: Post link does not work. Getting 404 page

Please check admin panel> settings > other settings and there is post url type. Pick something and save it

Issue: on Login/Registration

It because you have not correct mail configuration. System want to sent an email to new user but blocking by missing configuration. Please check Mail Configuration for mail setup.

Issue: on Video Create Page

If you get infinite loading screen when you post a video. It mean your server has mod_security option so your server does not allow us to post embed/iframe codes. Please turn off mod_security option on your server. If you do not know how to disable this then please contact with your hosting provider for it.

Issue: I have trouble with Facebook share

You need to set a valid Facebook app. Please check social login configuration tab for it.

Regular License

Use, by you or one client, in a single end product which end users are not charged for. The total price includes the item price and a buyer fee.

Extended License

Use, by you or one client, in a single end product which end users can be charged for. The total price inresurces

Buy Now!

v2.0 - 07/11/16

- Added: Theme System
- Added New Modern theme beside the Classic Buzzy theme (More theme will be soon)
--Modern theme Features
- More clean Layouts
- Two type headline for homepage (Headline Slider Type: http://akbilisim.com/assets/buzzy/modernheadline2.jpg)
- Improved Page Speed
- Sticky sidebars
- Lazy Load for images
- Improved Scroll Load/Load More options
- Ads/Widgets can be select for web or mobile on Modern Theme
- Reaction post lists
- Much More
- Added: New Category System. You can add subcategory for subcategory. Example: News > World > Europe
- Added: "Get content from the URL" button for BuzzyEditor. You can recreate existed post on site. Also you can get data from other sites.(This function currently in beta.)
- Added: You can select multiple categories.
- Added: Moved Main language selection to Admin Panel
- Added: Moved Mail configuration settings to Admin Panel
- Added: Moved all settings to .env file from the database. Now system will not overload by database connections for setting datas
- Added: Maintenance Mode option to Admin Panel

v1.3.2 - 16/12/15

- Added: Spanish Language files
- Fixed: Yes! Delete it! words on get image from url popup
- Fixed: Amazon S3 us-east-1 region image url issue
- Fixed: Feed posts not shows correctly
- Fixed: Other small issues

v1.3.1 - 10/12/15

- Added: Amazon S3 CDN Support for Image upload Check How to use it
- Fixed: Issue with load more button on category pages and homepage.

v1.3 - 26/11/15

- Added: User Follow System
- Added: Homepage Builder plugin now supports all subcategories.
- Added: "Save as Draft" Option for BuzzyEditor
- Added: Facebook Post entry for BuzzyEditor
- Added: Account activate email on user registeration.
- Added: 3 new widget area (Homepage first and second columns and Post page share buttons below)
- Added: Now category pages has infinite scrolling
- Added: More useful design changes
- Added: Language switcher on Footer (Only changing language strings)
- Added: Turkish, Russian language support.
- Added: Google Font selection to admin panel settings.
- Rework: Poll results has more Features
- Rework: Header sections has more useful dropdown menu.
- Rework: Search button area
- Rework: Social buttons has flat design
- Rework: Login/register popup has mini connect buttons on mobile
- Fixed: Reaction vote buttons has issue on mobile
- Fixed: Search issue on admin panel post lists
- Fixed: Issue with scroll top button and quiz auto scroll on Firefox
- Fixed: Other small issues

v1.2 - 05/11/15

- Added: New plugin system. Now all content types can be enabled/disabled
- Added: Reaction vote plugin
- Added: Homepage Builder(beta) plugin
- Added: Pagination on post pages. Now posts can be gallery style.
- Added: Now Post url supports: {type}/{slug} or {type}/{id} or {username}/{slug} or {username}/{id}
- Added: Prepare files for upcoming plugin Quizzes
- Added: RSS feed for all categories
- Added: Sitemap
- Added: New profile design and splash Image upload for users
- Added: VKontakte Logining
- Added: Improve login/register popup on mobile
- Added: Now footer has different logo upload option.
- Added: Staff/Editor users posts has auto approve
- Fixed: Source field not show up on text entry
- Fixed: Other small issues

v1.1.3 - 26/10/15

- Added: Staff/Editor role for users
- Added: User type badge on the post and user pages (Admin/Staff(Editor)/Banned)
- Added: Create Video page now support Tweet, Instagram, Soundcloud entries
- Added: Slug field on the category create form
- Fixed: Some servers automatically set posts featured issue
- Fixed: Some servers has logo upload issue
- Fixed: Issue with user setting changes
- Fixed: Twitter emoji issue with tweet entry
- Fixed: Buzzyeditor link issue
- Fixed: Other small issues

v1.1.1

- This update has minor bug-fixes

v1.1

- Added: Tweet Entry, Instagram Entry, SoundCloud Entry for BuzzyEditor
- Added: Facebook video support for BuzzyEditor Video Entry
- Added: Password reset system
- Added: Infinite lists or Load more button option for panel settings
- Added: New widget area to between 2./3. entries.
- Fixed: Failed login issue
- Fixed: Some missing language strings
- Fixed: Other small issues

v1.0.5

- Added: "Get image from the url" support for BuzzyEditor image entry widget.
- Added: "Make preview image" for BuzzyEditor image entry widget.
- Added: RTL support and also added option to the panel for RTL.
- Added: Scroll top button
- Added: Infinite lists on the homepage lists and post page "You may also like" area
- Removed id from the url for SEO. Now It just like example.com/{type}/{postslug}
- Fixed some small issues: alert on the poll options , search bug when you hit enter, panel banned user list, create button disappear on mobile devices.

v1.0.0

- Initial public release