You are here

README.txt in Splashify 7

Same filename and directory in other branches
  1. 8.2 README.txt
  2. 6 README.txt
DRUPAL SPLASHIFY MODULE
------------------------
Maintainers:
  Chris Roane (http://drupal.org/user/1283000)
Requires - Drupal 7, Library and jStorage (jQuery plugin)
License - GPL (see LICENSE)


1.0 OVERVIEW
-------------
Splashify is a full featured splash page module that is designed to be search
engine friendly. It is originally based on the Drupal 6 Splash module. It
allows you to specify a page to be displayed anywhere on your site, using one
of a few different delivery options (redirect, popup window or ColorBox). The
module also provides options specific to mobile devices.

The main focus of this module is the following:
- Be search engine friendly by redirecting via JavaScript (when applicable).
- Allow specific options for mobile devices.
- Allow different ways in delivering the splash page.
- Use ColorBox for displaying the splash page in a lightbox.
- You can have the system pick from a random list of splash pages, have a
list of splash pages show up in a specified order, display the specified
text/html in the site template or display the text/html full screen.

All of the features of this module have been confirmed to work in FF, Chrome,
Safari and IE7 through IE9.


2.0 INSTALLATION
-----------------
1. Download and enable the "Libraries" Drupal module. Version 2.0 or higher is
required.
Link: http://drupal.org/project/libraries

2. Download the jStorage library: https://github.com/andris9/jStorage/zipball/master
You will want to put the files in one of the following directories:
/sites/all/libraries/jstorage/
/sites/[site_name]/libraries/jstorage/

Splashify will be looking for "jstorage.min.js". So it should look something
like /sites/all/libraries/jstorage/jstorage.min.js

Below is a direct link to download the zip file.
Link: https://github.com/andris9/jStorage/zipball/master

3. If you want to enable options for mobile devices, you will need to add
the Mobile Detect library files: http://mobiledetect.net/

You can put the files into any of the following directories:
/sites/all/libraries/Mobile_Detect/
/sites/default/libraries/Mobile_Detect/
/sites/[YOUR_DOMAIN.COM]/libraries/Mobile_Detect/

4. Download and enable the latest version of the Splashify module.
Link: http://drupal.org/project/splashify

5. Verify there are no splashify errors on the Status report page
(admin/reports/status).

6. Configure the module. If the system can't find the jStorage library, it will
display an error.
Link: /config/system/splashify


2.1 CONFIGURATION
------------------
Go to "Configuration" -> "System" -> "Splashify" to find all the configuration
options.

If you are using the mobile options, you need to make sure to configure all
of the mobile settings on each tab for the mobile splash to work properly.

2.2 MOBILE SPLASH
------------------
In order to use the mobile splash options, the system must be able to find the
Mobile_Detect.php file from the Mobile Detect library:
http://mobiledetect.net/

Below are a few options in where you can put the file:
/sites/all/libraries/Mobile_Detect/Mobile_Detect.php
/sites/default/libraries/Mobile_Detect/Mobile_Detect.php
/sites/[YOUR_DOMAIN.COM]/libraries/Mobile_Detect/Mobile_Detect.php

One this file is there, you should see the Mobile settings appear on the When
tab of the Splashify config area: /admin/config/system/splashify

3.0 PROBLEMS OR FEATURE REQUESTS
---------------------------------
First make sure an issue doesn't already exist. If it doesn't, create a new
issue: http://drupal.org/project/issues/splashify


4.0 TODO
--------
- Need to do more in depth mobile browser testing.


LAST UPDATED
-------------
09/09/2012


SPONSORS
--------
This module has been sponsored by The Brick Factory (thebrickfactory.com).

File

README.txt
View source
  1. DRUPAL SPLASHIFY MODULE
  2. ------------------------
  3. Maintainers:
  4. Chris Roane (http://drupal.org/user/1283000)
  5. Requires - Drupal 7, Library and jStorage (jQuery plugin)
  6. License - GPL (see LICENSE)
  7. 1.0 OVERVIEW
  8. -------------
  9. Splashify is a full featured splash page module that is designed to be search
  10. engine friendly. It is originally based on the Drupal 6 Splash module. It
  11. allows you to specify a page to be displayed anywhere on your site, using one
  12. of a few different delivery options (redirect, popup window or ColorBox). The
  13. module also provides options specific to mobile devices.
  14. The main focus of this module is the following:
  15. - Be search engine friendly by redirecting via JavaScript (when applicable).
  16. - Allow specific options for mobile devices.
  17. - Allow different ways in delivering the splash page.
  18. - Use ColorBox for displaying the splash page in a lightbox.
  19. - You can have the system pick from a random list of splash pages, have a
  20. list of splash pages show up in a specified order, display the specified
  21. text/html in the site template or display the text/html full screen.
  22. All of the features of this module have been confirmed to work in FF, Chrome,
  23. Safari and IE7 through IE9.
  24. 2.0 INSTALLATION
  25. -----------------
  26. 1. Download and enable the "Libraries" Drupal module. Version 2.0 or higher is
  27. required.
  28. Link: http://drupal.org/project/libraries
  29. 2. Download the jStorage library: https://github.com/andris9/jStorage/zipball/master
  30. You will want to put the files in one of the following directories:
  31. /sites/all/libraries/jstorage/
  32. /sites/[site_name]/libraries/jstorage/
  33. Splashify will be looking for "jstorage.min.js". So it should look something
  34. like /sites/all/libraries/jstorage/jstorage.min.js
  35. Below is a direct link to download the zip file.
  36. Link: https://github.com/andris9/jStorage/zipball/master
  37. 3. If you want to enable options for mobile devices, you will need to add
  38. the Mobile Detect library files: http://mobiledetect.net/
  39. You can put the files into any of the following directories:
  40. /sites/all/libraries/Mobile_Detect/
  41. /sites/default/libraries/Mobile_Detect/
  42. /sites/[YOUR_DOMAIN.COM]/libraries/Mobile_Detect/
  43. 4. Download and enable the latest version of the Splashify module.
  44. Link: http://drupal.org/project/splashify
  45. 5. Verify there are no splashify errors on the Status report page
  46. (admin/reports/status).
  47. 6. Configure the module. If the system can't find the jStorage library, it will
  48. display an error.
  49. Link: /config/system/splashify
  50. 2.1 CONFIGURATION
  51. ------------------
  52. Go to "Configuration" -> "System" -> "Splashify" to find all the configuration
  53. options.
  54. If you are using the mobile options, you need to make sure to configure all
  55. of the mobile settings on each tab for the mobile splash to work properly.
  56. 2.2 MOBILE SPLASH
  57. ------------------
  58. In order to use the mobile splash options, the system must be able to find the
  59. Mobile_Detect.php file from the Mobile Detect library:
  60. http://mobiledetect.net/
  61. Below are a few options in where you can put the file:
  62. /sites/all/libraries/Mobile_Detect/Mobile_Detect.php
  63. /sites/default/libraries/Mobile_Detect/Mobile_Detect.php
  64. /sites/[YOUR_DOMAIN.COM]/libraries/Mobile_Detect/Mobile_Detect.php
  65. One this file is there, you should see the Mobile settings appear on the When
  66. tab of the Splashify config area: /admin/config/system/splashify
  67. 3.0 PROBLEMS OR FEATURE REQUESTS
  68. ---------------------------------
  69. First make sure an issue doesn't already exist. If it doesn't, create a new
  70. issue: http://drupal.org/project/issues/splashify
  71. 4.0 TODO
  72. --------
  73. - Need to do more in depth mobile browser testing.
  74. LAST UPDATED
  75. -------------
  76. 09/09/2012
  77. SPONSORS
  78. --------
  79. This module has been sponsored by The Brick Factory (thebrickfactory.com).