FAQ

From SocialStrap Wiki
Jump to: navigation, search

Contents

Before you contact me

  • Read the full documentation file.
  • Check if your question is not already in this FAQ.
  • If you just purchased your license please take your time to explore this complex software and all it's features.
  • Use this group http://live.socialstrap.net/webdevs for general question or feature requests.
  • Sometimes there are too many emails and I simply cannot answer to each one.
  • Support for SocialStrap is optional but I'll do my best to help.
  • Support doesn’t mean customization.
  • I do not support errors caused by strong modification to the original files.
  • I can’t teach you how to code in HTML, CSS, PHP or any other language.


I have a problem

General Troubleshooting

  • check application log file app/log.txt
  • remove newly installed addons or language files
  • if you can't reach Settings put your app into 'safe' mode by editing Application environment inside config.php file
  • you can disable all addons by visiting Setting -> General -> Load addons
  • if your problem is solved after disabling addons try to enable them back one by one and see which one is causing problems
  • some addons are overlapping and cannot work together
  • if you've made some modifications to the files restore original ones


I can't login after installation

This error usually means that your server cannot process .htaccess file where important rewriting rules are applied. See below:

I have Godaddy hosting

If you are on Godaddy hosting then you must replace .htaccess file with the one from this archive http://www.socialstrap.net/misc/godaddy.zip

I have Godaddy windows shared hosting

GoDaddy might not support PDO on a Windows shared hosting plan by default. If you have this hosting package try updating the PHP from 5.3 to 5.4 in cpanel – programming languages.

I have Hostgator hosting

On old HostGator servers still running on PHP 5.2 as a default version replace .htaccess file with the one from this archive: http://www.socialstrap.net/misc/hostgator.zip You may need to repeat this step one more time after installation.

I have my own Linux server with Apache2

  • First, ensure that a .htaccess file is in fact being read, put garbage in it. An invalid line, such as "INVALID LINE HERE", in your .htaccess file, will result in a 500 Server Error. If it doesn't, then you don't have AllowOverride configured correctly.

Example:

<Directory /var/www/html/mynetwork>
	Options FollowSymLinks MultiViews
	AllowOverride All
	Order allow,deny
	allow from all
</Directory>

  • Restart your httpd service.

You can try few more variants of .htaccess file from here: http://www.socialstrap.net/misc/htaccess_variants.zip


I am getting error 500 when I click on links

Make sure the script can read and write to all files and folders. If you have socialstrap installed under sub-folder try to add this line to your .htaccess file:

RewriteBase /mysubfolder

You can also try with the above FAQ and different .htaccess variants: http://wiki.socialstrap.net/index.php?title=FAQ#I_can.27t_login_after_installation


What is my item purchase code and where can I get this

I bought this script from interactive32 / 2checkout

Please check the purchase confirmation email sent to you by interactive32, your item purchase code should be there.

I bought this script from CodeCanyon

You can see your item purchase code when you click on download button here: http://codecanyon.net/downloads and then on "License certificate & purchase code"

Your Item Purchase Code will be something like this: 9755b6a4c-d817-4ee9-9577-6064af38b923

Check this video tutorial: http://www.youtube.com/watch?v=IhEHria33mI


There is no "Themes" menu link on my installation?

Theme selector add-on is installed on my live preview site and this is not a part of the script when you buy it. You can of course select one of 12 pre-installed themes as admin inside Settings -> Themes & Style.

You can still have this add-on, it's free. Download it from here: http://www.socialstrap.net/addons/ unzip it and upload to your addons/ folder.


I cannot upload images

This usually means that your web server cannot write to all folders. You must change folder permissions so application can write images on your server.

Most important folders and sub-folders that need read+write permissions are:

  • tmp/
  • storage/
  • storage/avatars/
  • storage/covers/
  • storage/posts/
  • images/
  • addons/ (and all subfolders)


Mobile Phone Support

SocialStrap supports image upload from most modern smart phones. We are using blueimp upload library and you can see compatibility list on their web site: https://github.com/blueimp/jQuery-File-Upload/wiki/Browser-support

Please note that you can only upload small images on live preview site due to limited disk space. We did a test on several mobile devices including android, iPhone and iPad check this: http://live.socialstrap.net/search/posts/?term=%23imagetest


I have problems inserting banners, ads or AdSense code

When I save something with quotes they become escaped

Example: " becomes \" or ' turns into \' or even \\\\'

You have “magic quotes” setting enabled on your server. This is a depreciated server’s feature and has to be disabled. If you cannot disable that in your control panel you can try adding this code to socialstrap config.php file:

if (get_magic_quotes_gpc()) {
    function magicQuotes_awStripslashes(&$value, $key) {$value = stripslashes($value);}
    $gpc = array(&$_GET, &$_POST, &$_COOKIE, &$_REQUEST);
    array_walk_recursive($gpc, 'magicQuotes_awStripslashes');
}

I cannot input code with <script> tags

Server is filtering the input or blocking with '403 forbidden' assuming that you are trying to insert malicious code. This feature has noting to do with SocialStrap and has to be disabled on your server or cPanel.

This can be some kind of firewall but it's usually mod_security settings (SecFilter, SecFilterScanPOST). If you can't switch this thing off, talk to your system administrator or hosting company.


I can’t see reviews.. the right pane on the reviews is blank

Nothing is reported yet that’s why it’s all blank.

I have this error: Input error: k: Format of site key was invalid

This is coming from ReCaptcha service, your domain name or ReCaptcha key is wrong. Visit Settings -> General and fix or disable ReCaptcha. Please note that example.com and www.example.com are different domains.


Using SocialStrap

How Can I setup Facebook login?

You need to register as a Facebook developer (https://developers.facebook.com/) and to create an app for your website.

Steps on Facebook:

  • Go to http://developers.facebook.com and click on Apps -> Create a New App.
  • Enter "Display Name", select a category and click on the "Create App" button.
  • Open your newly created App and check for App ID and App Secret on "Dashboard" tab. Copy & Paste those two into your SocialStrap Settings -> General.
  • On Facebook site click on your App and select "Settings" tab. Fill the field "Contact Email" with your contact.
  • On the same tab click on "+ Add Platform" and select "Website". On following screen fill the "Website URL" field with your site's URL and save changes. Note that http://www.example.com and http://example.com are not the same.
  • Now open "Status & Review" tab and switch ON the first option "Do you want to make this app and all its live features available to the general public?"

Video screencast: https://www.youtube.com/watch?v=njyOViBcK-c


What is an add-on and how can I install one?

Please visit this link to find out more about add-ons: Quick introductions to add-ons


How can I create pages and groups?

Navigate to:

Edit Profile -> My Groups / My Pages

and click on a button to create a group/page


What is the difference between pages and groups

While Pages were designed to be the profiles for entities, such as celebrities, brands or businesses, Groups are the place for small group communication and for people to share their common interests and express their opinion. Groups allow people to come together around a common cause, issue or activity to organize, express objectives, discuss issues, post photos and share related content.

Pages don't have privacy, they are always public and visible to all users and guests. Only the admin of a page can post there but the post's author (and avatar) will represent the page itself.


I want to allow only registered users to view my site

There is an option in admin panel for this: ”Allow public posts so the guests can explore the site”. Go to Settings -> General and disable this option.


I want to have a landing page instead of timeline

Go to addons http://www.socialstrap.net/addons/ and download "Splasher" addon. With this addon you can have your custom landing page.


Can I prevent users from creating groups/pages

There is an option called "User can manage groups and pages". If you uncheck this users will not be able to create groups and pages.


What’s the story with badges? How can we use this feature?

Admin can assign badges to users, groups and pages. Search for users and then click on Edit button. For example, you can assign “ok” badge to some users so they can appear as “verified”.

You can pick from 200 different glyph icons: http://getbootstrap.com/components/#glyphicons

and you can add translations for each one to your language files app/core/languages/*.php like this:

"bullhorn" => "One Fine Badge",
"camera" => "Cameraman",
"ok" => "Verified user/page",

Check this sample: language sample


How can I add friends

There is no such thing as "add as friend" on SocialStrap. You can follow someone and if he/she decide to follow you back you two will become friends. SocialStrap is using following system such as that of Twitter so your users can manage their relationships in most natural way.


How 'Friend suggestions' and 'Popular users\groups\pages' work?

All this is a part of "Power Lobby" addon. This addon is doing pretty complex math to match profiles which can be interesting for the current user. Please note that this add-on will cache this data for some time to reduce the server load.

Friend suggestion

This box will suggest friends of your friends and users following the same users as you in 50:50 ratio excluding people you already follow. Stop for a minute to understand this logic completely.

Popular users

Those are users with non-private profile security settings who have a highest number of recent followers excluding people you already follow.

Popular groups

Non-secret groups with a highest number of recent members excluding groups you have already joined.

Popular pages

Popular pages are those with most likes.


What does the "security off" notice mean

This notice simply means that you are logged in as an admin or a reviewer and you can see some posts that would normally be hidden. For example you can see some posts written to friends only without actually being a friend with an author. (removed since v1.8)


What are mentions?

A mention is when someone writes your username like this ”@george” anywhere in the post. SocialStrap collect these posts in the Mentions tab on the Search page. You will also receive a notification when this happens.


Number of likes on image does not match the number of likes on the post?

Users can like a post but they can also like (or comment) each individual image on the post. Those are two separate things. Example: You can have 5 images on a single post, image No.4 is super cool and it will receive 50 likes while others are not so great and they may have 3, 6 or 8 likes. On the other hand the post itself can have 23 likes.


The layout is different on my language

The length of words varies from language to language. Content written in one language may take up more or less space on the page than another language. Because of this problem it is not possible to make the same layout on every language. You can overcome these types of problems by using shorter words to fit in to the available space. Another way would be to tweak your custom css (Settings -> Themes & Style) and to add some custom style like this one:

@media (max-width: 480px) {
  .btn {
    padding:2px 4px;
    font-size:70%;
    line-height: 1;
  }
}


Emails are going straight to peoples spam folder

Technically, php scripts do not send emails, that's server's job. In the past email service on the Internet has been abused so many times that noways most IP addresses and servers are blacklisted.

In SocialStrap you can overcome this problem simply by configuring which server will send your emails.

Log in as admin and go to Settings -> Email.Setup

There are two options:

1. php mail() - this is default, emails are sent trough the server on which the script is installed. If you are on shared hosting there is a big chance that your server is blacklisted and all emails sent from SocialStrap will probably be marked as a spam. On the other hand, if you have your own, well configured and maintained server, this will be the fastest way to send emails.

2. smtp - with this driver you can configure and use remote server or email service to send emails. I highly recommend this method in combination with Mandrill email service (http://mandrill.com/ free for 12.000 emails per month). You can even configure and use gmail with smtp. When you use proper email service you can see what is going on and easily track which emails are delivered.


How can I integrate with MailChimp?

First you have to open MailChimp account, create a mailing list which will hold your SocialStrap users and to create a new API Key which will connect two applications together. API Key options on MailChimp are under Account Setting -> Extras.

Then, upload mailchimper add-on to your SocialStrap addons folder, log in as admin and go to Addons -> Mail Chimper. Enter your Mailchimp API Key into the box and click on update. If your API is ok on next screen you will be able to select a list where new users will be subscribed automatically. Click on update again and you’re done.


Customization

I need to customize/add some feature and to change the layout

I am not available for customization or freelance at the moment. You can try to find developers here: http://live.socialstrap.net/webdevs or at some freelance site.

Most important thing to remember here is that support doesn’t mean customization.


I have an awesome idea / feature request

Please post your ideas here http://live.socialstrap.net/webdevs so other developers and users can join your discussion and contribute.


General Questions

How can I update SocialStrap?

There are two ways to update this script: automatic and manual. Automatic is much faster and easier but it's a bit risky since it will overwrite all files.

First backup everything, especially if you have done some customization to the core files. Download the latest version from interactive32 and follow instructions from updates/README.txt

Make sure your web server has full permissions on all files and folders. Double-check whether this is still the case after you update the script.

Automatic update

If you haven't changed any files or customize the app too much you can upload only four main files to your server and application will update automatically. See this screenshot: http://wiki.socialstrap.net/images/updating_socialstrap.png

After the automatic update you can restore all your custom files back, probably some layout changes, email templates etc.

Manual update

To manually update your SocialStrap, unzip all files from data.zip archive and look into each new version txt file in updates/ folder for which files needs to be replaced on your server. If you skipped some update then you must read instructions and replace files for all versions in between, up to the current version using, files from the latest version.


Why are pop-up images so small on live preview?

On live preview image re-sampling feature is on. This feature enable site owner to save on disk space by shrinking uploaded images to specific size. In addition, there is an option to keep the original file so the image can be downloaded in full-size.


What is the difference between roles user and subscriber?

By default there are no differences but you can make one with different settings. For example you can disable custom background image for users but allow this for subscribers. You can do something similar with pages and groups.


Can I use this on share hosting like hostgator or dreamhost?

Yes, you can install this on shared hosting, however, shared hosting may impose some limitations and restrictions. Hosting companies base their shared hosting business on many small customers with one or two WordPress sites. That way, they can charge a small price to a lot of people sharing the resources of a single server. If you have a small group of active users you can stay on shared hosting for a very long time but when your community starts to grow you will have to buy your own server.

So how many users can I have on a shared hosting plan? This depends on many things, mainly on your users activity. If they are very active, clicking, liking, following using groups and pages and get notified all the time you will hit the limit very fast. You cannot compare social networking script with a WordPress or similar because blog sites or scripts with very limited features don't consume that many resources.


Is this secure?

Nothing on the Internet is safe and secure. The real question is - is this secure enough? SocialStrap has been built by professionals using the best security practices. Furthermore, the script has been tested against the leading security scanners. However, you are solely responsible for your server, database, files and data so here are some basic security guidelines you can follow to reduce those risks to minimum:

  • Always use the latest SocialStrap version, updates sometimes contains security patches and improvements.
  • Pick strong password for your admin account, if someone knows your admin password he can take over your server.
  • Try not to use shared hosting, sharing your files with strangers is never a good idea.
  • Not all 3rd party addons are safe. One insecure or badly written addon can compromise your entire server.
  • Hacker can attack your server through other software, cms systems or ftp. If one software on the server is insecure everything else will be insecure too.
  • Never download or use pirate copies, they are most probably altered and may contain some hidden code.
  • SocialStrap need to write to some files but give your files only the minimum permissions to allow this. Ask your system administrator or a hosting company which permissions are more suitable on your installation.
  • Backup your files and databases and watch your server's logs regularly.
  • Enable ssl on your server and accept only https connections. This way all communication between user and server will be encrypted.
  • Test everything with non-critical data before going live.

If you suspect that your site has been hacked try to collect as much details as you can about the attack. How the hacker did this, what changes did he make, which versions of software you had, list of any additional addons or scripts on the same site, server logs etc.