Drupal original modules

pict-drupal-module.png Introducing PIXTURE STUDIO original Drupal modules.
Some modules are distributed only at this site, not at the drupal.org.

Please refer to the README file and/or the project page upon installig and using theme modules, and use it at your own rick. PIXTURE STUDIO is not responsible with any direct/indirect damages caused by the use of these modules.

Your rating: None Average: 2 (5 votes)

Admin Default Filter

pict-drupal-module.png Admin Default Filter is an original and very small and simple Drupal module, which force to use the default filter for admin users to Full HTML.

Drupal 6 does not allow to specify default input format for each role. So the default input format for admin should be same as the one for anonymous users, which is not convenient for an admin user because he/she may need to change the input format everytime a new message is created. That's the reason I have created this very simple module.

It's so simple and small and there's no settings or GUI for the module. It just force to use Full HTML when the admin user create a new content.

ss-admin-default-format-e.png
There's a module Remember Filter which can do the similar thing but more customizable and flexible. This module remember the last input filter used for each role and then use the input filter it remembered for the next time. I know this works for me but I just want to use Full HTML all the time no matter which input filter used for the last time. So I created this very simple module by myself.

 

AttachmentSize
admin_default_filter-6.x-1.x-dev.tar.gz6.75 KB
No votes yet

AntiSpam

pict-drupal-module.pngAntiSpam module is a Drupal module that provides interface with external anti-spam services such as Akismet, TypePad AntiSpam, Defensio. This module is developed based on the Akismet module.

Features of the AntiSpam Module

  1. Akismet module was not completedly ported for Drupal 6.x. There were many bugs remain for the 6.x version. AntiSpam module has fixed all the compatibility problems with Drupal 6.x.

  2. You have more selections for the external antispam services. You can select one of the following external antispam services.
  3. If the Defensio service is selected, it takes advantage of Defensio's "Spaminess" feature. You can see the spaminess
    ss-antispam-1.png
    The above image is the screenshot of the AntiSpam moderation queue. You can see the spamineses level by the nice graphics meter. You can sort the list by the spaminess.

  4. AntiSpam modules keep tracks of the record of antispam activities. You can see the number of spams, hams, false negatives and false positives with nice graphic charts at the statistics page. (see the image below).

    ss-antispam-2.png
    You can adjust the size of the chart from the configuration settings page.


Using AntiSpam module

Please download the latest stable release from http://drupal.org/project/antispam
Then copy the archive to the module directory and extract it there just like other Drupal modules.
Basic usage of the AntiSpam module is same as the Akismet module, so please see this page for how to use Akismet module.
http://www.pixture.com/drupal/node/77


Select an external antispam service

Biggest feature of the AntiSpam is that you can select an external antispam services from either one of the Akismet, TypePad AntiSpam and Defensio servies.

Akismet was the oldest antispam service and it's a standard antispam service at WordPress.com, and it has good reputations. However, when it comes to the usage at the commercial sites, there are some limitations and you may have to pay some fee to use for commercial sites.
On the other hand, TypePad AntiSpam service provids total free antispam service even for the commercial sites. This is the reason I have started developping this module.

Below is the simple comparison of the popular antispam services.

Akismet TypePad AntiSpam Defensio Mollom (*1)
Sponsored by Automattic Six Apart WebSense Mollom
Primary software platform WordPress TypePad N/A Drupal
For individual, non-commercial sites Free Free Free Free
For commercial sites Some fees Free Some fees Some fees
Supplemental CAPTCHA No No No Yes
Spaminess indicator No No Yes No
Learning feature Yes Yes Yes Yes
Spam filtering rule by individual No No Yes No
Statistics page No No Yes Yes(for commercial)
Published API for external program Yes Yes(100% compatible with Akismet API)(*2) Yes Yes
As of 2009.5.18

(*1) "Mollom" is founded by Dries Buytaert, the founder of the Drupal. Thefore the compatibility with Drupal is high and reliable. Mollom module, a module for Drupal is available.

(*2) TypePad AntiSpam publishes their spam detection engine as open source. (However, the rule they are using with the engine is hidden).

It is not easy to determine which service to choose. However, if you run commercial sites and you do not want to pay the service fee, TypePad AntiSpam is the only choice you have right now. If it's for non-commercial personal site, then you can use any one of them free of charges. I would recommend that you try some of them for a while and then decide which one worked best for your site.

Like the Akismet service, you are required to register and obtain API key for TypePad AntiSpam and Defensio services too. I do not explain the detail about this here. Please see more details at service provider's web site. Below is the screenshot of TypePad AntiSpam and Defensio API-key.

ss-defensio-1.png

ss-typepad-1.png

API for other modules

AntiSpam module 1.0 has introduced an API function for other modules to check any text data they have using external antispam service configured by AntiSpam module.
  1. function antispam_api_cmd_spam_check($body, $name=NULL, $mail=NULL, $homepage=NULL);
  2.  
  3. Parameter:
  4.  $body - text data to be checked
  5.  $name - (optional) author name
  6.  $mail - (optional) author email
  7.  $homepage - (optional) author homepage
  8.  
  9. Return:
  10.  -1: Error
  11.  0: The text is HAM (not spam)
  12.  1: The text is SPAM
This API function make it possible any modules to check any text data entered by users using AntiSpam module, and determine what to do based on the check result.


Links

AntiSpam project page at Drupal.org
http://drupal.org/project/antispam

AntiSpam open issues and bug reports
http://drupal.org/project/issues/antispam

 

Your rating: None Average: 2.5 (6 votes)

Public Download Count

pict-drupal-module.png This is an original Drupal module that keep track of file download count.

The biggest different between Download Count module and this module is that this module works under the Drupal's public file system while Download Count module works under the Drupal's private file system.

First of all, let me briefly explain about the Drupal's two file systems.

Drupal's file system

  • Public file system
    Uploaded files are directly downloaded from the server using HTTP. Drupal does not have any control over this downloading process. The files are needed to be placed to the directory under the server's DocumentRoot directory so that it can be directly accessed.
    All uploaded files can be downloaded by anyone, and even can be downloaded by tying the files URL directly without going through the download page. As default, Drupal uses public file system.

  • Private file system
    Uploaded files are placed to a directory where users can not directly download them. Drupal has to process the download request and handle it.
    Usually you create a directly outside of the server's DocumentRoot so that the file can not be downloaded directly by specifying the URL. The special file path including '/system/file/...' is used for this file system. You can limit the download by roles, users, etc...

If you want a secure and more control over the files you distribute at your site, you'd better use the private file system with Download Count module.

Public Download Count module is intended for the following people:

  1. Those who needs to use the public file system for some reasons, and yet want to keep track of file download count.
  2. Those who want to keep track of download count of the files on different servers.


Key features


Using Public Download Count module is similar to use external file download CGI program. The anchor HTML tag for a direct file download is automatically converted to use the external PHP script of this module on the fly instead of using Drupal's internal hook mechanism. This is totally different from the Download Count module although the functionality is similar. With this anchor tag conversion method on the fly, Public Download Count module can count the number of download of the files that are located on the external sites.


Installation

Download the module at the Public Download Count project page at Drupal.org. Then, extract the archive at the module directory of your site. Then, enable the module at the Administer > Site building > Modules page.

If you install the module to neither (drupal-root)/modules directory nor (drupal-root)/sites/(your-sitename)/modules directory, then you may need to do the following extra steps to make this module work.

The external PHP script (pubdlcnt.php) may not work as it is depending on the installation directory. If you see any error message when you testing the file download with this module enabled, please edit the top portion of this file as follows:

Before
  1. print "Error: Public Download Count module failed to work. The file pubdlcnt.php requires manual editing";
  2. chdir('/absolute-path-to-drupal-root/'); // <---- edit this line!

After
  1. // print "Error: Public Download Count module failed to work. The file pubdlcnt.php requires manual editing";
  2. chdir('/www/server/html/drupal/');

As you see above, delete the line that displays an error message and then change the next line with actual absolute path to the Drupal root of your server. Besides, this is just a example, and you need to replace 'absolute-path-to-drupal-root' with the real absolute path that matches to your server and Drupal installation.


How to use (1) Module configutation

Once the installation is completed, go to the Administer > Site configuration > Public Download Count page, and specify the file name extensions of the target files. Extensions are case insensitive.

ss-pubdlcnt-3.png
That's all you need to do. Now, the module is ready to work.


How to use(2) View download counts

To view the download counts of files, go to the Administer > Reports > Public Download Count page. You will see the list of files and their total download count (see the example below).

ss-pubdlcnt-1.png
Clicking file name will jump to the page(node) where you can download the file. To reset the download count of a file to 0, click the "Reset" link. To view the detail download count statistics of a file, click the "Details" link.

When you click the "Detail" link, you can see the yearly, monthly and daily download count of the file (see the example below).

ss-pubdlcnt-2.png

How to use(3) Export download count data

You can export the file download count data as a CSV format (comma separated text format) file, which you can open with Excel and other spreadsheet programs later.

ss-pubdlcnt-4.png

How to use(4) Display download count in nodes

As you can see the example below, Public Download Count module can display the total download count of the file right after the link to download the file.
ss-pubdlcnt-5.png
If you are an administer, then clicking the download count will jump to the detail download count statistics page of the file.

You can show this total download count to any users (without the link to the statistics page).

To do this, go to the Administer > User management > Permissions and enable the "view total download count in nodes" checkbox for the role you want to allow.


ss-pubdlcnt-6.png

How to use (5) Creates blocks

This modules can show top download file list of specified time period to a block. You can create as many blocks as you like at the module's configuration page. Once you specify the number of blocks you want to use, then the blocks are created. Go to the Blocks page and customize each blocks.
ss-pubdlcnt-8.png
You can specify the number of items to be shown to a list. You can also select if you want to add anchor to nodes of which the files can be downloaded. For the time period of counting, you can select either one of Last Year, This Year, Last Month, This Month, Last Week, This Week, Yesterday and Today.

The block you creates would look like this.
ss-pubdlcnt-7.png
Clicking file name will jump to the node(page) where user can download the file. You can also show the download count after the file name depending of the user role and permissions. You can assign the permission "view total download count in block" to the role you want to show the counter value.
Only the admin user have the count with the anchor to the statistics page of the file.

Technical Details

Public Download Count module works with any anchor tags that meets the following criteria.

  1. The anchor tag must have URL with a file name at the end. It does not work with the anchor tags whose URL is a directory name
  2. The anchor tag must not have a query string. For example, the following anchor tag is ignored by the module.
    <a href="http://example.com/prog.php?param1=XXX¶m2=YY">
  3. The anchor tag must have a file name with a valid file name extensions specified at the module configuration page.
  4. The anchor tag must not have a file path to the private file system (which includes /system/files in its path)
  5. The anchor tag must be in nodes, not in comments. This module does not handle anchor tags in comments.
  6. The anchor tag must not have "rel=lightbox..." attribute. (thickbox and shadowbox too).

NOTE: Public Download Count module conflicts with the image files that uses lightbox, thickbox and shadowbox. So currently they are excluded from the target.

 

Your rating: None Average: 3.8 (13 votes)

SEO Watcher

SEO Watcher is our original Drupal module that searches specified keywords with major search engines and checks the rank of your site and competitive sites once a day and creates the reports.

ss-seowatcher-0.png

Feasures


There are tools and online services which can do the same or similar things. However, this module integrates the functionality directly to Drupal. Once you install and set up the module, everything is done automatically on daily basis. All you need to do is check email reports everyday. It couldn't be easier.


Result Reports

ss-seowatcher-1.png
Check result is shown in nice tables at Administor > Reports > SEO Watcher page. The ranking of your site is shown first, followed by the competitive analysis reports.

The past ranking of your site is shown in line charts.

ss-seowatcher-2.png
When you enable the option to send an email of check result to admin every day, a HTML mail like below will be sent. It has similar tables and hyper links to the report page, search engine page and competitive sites.

ss-seowatcher-3.png

Settings

You need to specify at least one keyword. SEO Watcher does nothing if no keywords are specified. Competitive analysis is an option. If you add your competitors, please specify their absolute URL starting with http://.

Please try to make the maximum search rank as small as possible since it may give an direct impact on the time required to complete the ranking check, as well as the number of keywords.

ss-seowatcher-4.png
When you check the last check box (see above), the temporary ranking check is performed with the update settings upon saving the settings.
This may be useful when you determine the best keywords and competitive sites by trying it repeatedly. The result of this temporary ranking check is not stored anywhere. Only the ranking check performed during the cron operation is stored to the database. This ranking check will not be performed more than once a day even if your site runs cron job more frequently.


Technical notes

Major search engine companies usually offer API (Application Programing Interface) for external software/web sites to use their search engine and search results. Ideally, using such API is the best way to achieve the goal of this module. However, there are certain restrictions and limitations of using of such API, and I was not sure if the software like this module can legally use such APIs or not. I wanted to avoid the worst case where the user of this module have their server's IP-address banned by search engines due to improper usage of their API. Therefore, this module intentionally avoid using such APIs. So this module just sends the reqular search query to search engines just like manually using search engines. So please do not ask us why this module does not use such APIs.


Important Note and Disclaimers

This module sends search query to search engines for each keywords and get the result up until the maximum search rank just like you do manually with web browser. Therefore, it's a time consuming task and may take a few minutes or even longer depending on the number of keywords and maximum search rank. Logically, if you increase the number of keywords from one to three, the ranking check process may takes three times longer than now. That's the reason why we are asking you to try to minimize such factors as possible as you can. Besides, number of competitors sites does not have such dramatic impact on the time required because it does not increase the amount of data receives from search engines.

Anyway, to avoid worst cases I mentioned earlier, please do not modify this module to increase the number of keywords and/or maximum search rank. This would increase a risk of such worst cases. I think it would be OK to run the ranking check once a day with this kind of limited volume of search query. But please use this module at your own risk, and PIXTURE STUDIO is not responsible for any direct/indirect damages caused by the use of this module.


Download

The latest version of SEO Watcher is always available at the project page of drupal.org.

SEO Watcher
http://drupal.org/project/seowatcher

 

Your rating: None Average: 3 (2 votes)

World Clock

pict-drupal-module.png This is a Drupal 5.x/6.x module that displays a worldclock to a block.

I originally developed this as a sidebar widget for WordPress, and ported for Drupal.

Features



Screenshots

Module Settings Page 1
ss-worldclock-2.png
Module Settings Page 2
ss-worldclock-3.png
Actual Sample

ss-worldclock.png

Download

Download the latest stable version from the project page at Drupal.org.

Worldclock Module Project
http://drupal.org/project/worldclock

 

Your rating: None Average: 5 (1 vote)

brbr line break filter

pict-drupal-module.png brbr line break filter is an original Drupal module that replaces the standard line break filter.

Since Drupal's standard line break filter mainly uses <p></p> tag and multiple line breaks can be combined into a single line break, I do not like it. That's the reason I created this original filter module.

As you can guess from its name, brbr line break filter uses <br /> tag for all the line breaks and it maintains multiple line breaks. Then, it wraps the entire article with <p></p> tag so that layouting with <p></p> tag still works OK too.

Here's an example of how brbr line break filter works.

brbr-screen.png
Drupal's standard line break filter would generates the following HTML code.

  1. <p>This is test article</p>
  2. <p>This is 3rd line</p>
  3. <p>This is 6th line (2 blank lines above)<br />
  4. This is 7th line</p>

While, brbr line break filter would generates the following HTML code.
  1. <p>
  2. This is test article<br />
  3. <br />
  4. This is 3rd line<br />
  5. <br />
  6. <br />
  7. This is 6th line (2 blank lines above)<br />
  8. This is 7th line</p>

As you can see above, brbr line break filter replaces each line break with <br />. Therefore, multiple line breaks are retained. Also it wraps the entire article with <p></p> tag for the layouting compatibility purpose.

Since this is a simple module and it's not a major one, we are distributing this module only at this side.

After you install this module to your Drupal, you need to activate the filter at the Administer > Site Configuration > Input Format page. Do not forget to disable standard line break filter too if you use this brbr line break filter.

This modules is developed for Drupal 6.x, but it can be used with Drupal 5.x too. In order to use it with Drupal 5.x, you need to edit enclosed brbr.info file and change "core = 6.x" to "core = 5.x".


AttachmentSize
brbr-6.x-1.0.tar.gz7.36 KB
Your rating: None Average: 3.3 (8 votes)

TinyBrowser (1) Introduction

pict-drupal-module.pngTinyBrowser module is a Drupal module which integrates TinyBrowser with TinyMCE or FCKeditor.

What is TinyBrowser?

TinyBrowser is a custom file browser plugin developed for the TinyMCE WYSIWYG content editor. It is developed by Bryn Jones at Lunarvis, and distributed under the GNU General Public License.

Feature of TinyBrowser


*NOTE* The feature list above is an extract from original TinyBrowser's web site.

Below is the TinyBrowser's browser window for the image files. As you can see, it uses thumbnails to make the image file browsing easy and intuitive.

ss-tinybrowser-1.png
Below is the file upload panel the TinyBrowser. It uses Flash based front-end program to make it possible to easily upload multiple files at a time. This is the biggest advantage of TinyBrowser compared with other file browsers.

ss-tinybrowser-2.png TinyBrowser module is developed to integrate TinyBrowser to Drupal, with some additional features which are important for CMS like Drupal.

Feature of TinyBrowser module


Requirement

  1. CleanURL is enabled.
  2. $cookie_domain is enabled and defined in the settings.php of the site.
  3. PHP safe_mode OFF.
  4. No Javascript aggregation and optimization.
    TinyBrowser would work neither Javascript Aggregator module nor Optimize Javascript file setting ON at Administer > Site configuration > Performance setting page.

Usage Limitation

TinyBrowser can be used only by authenticated users for the security reasons.

Installation

  1. First, download the latest archive of TinyBrowser module from the project page at Drupal.org.
    TinyBrowser module
    http://drupal.org/project/tinybrowser

    Extract the archive at the sites/all/modules directory just like any other 3rd party Drupal modules. A new directory named 'tinybrowser' will be created. TinyBrowser module includes the entire source code of TinyBroswer. Therefore, you do not need to download the TinyBrowser separatedly.

  2. If the $cookie_domain is not enabled nor properly set, enable and set it at the settings.php for your Drupal site. You need to change the permission of the settings.php to writable and then edit and reset it back to read-only.

  3. Go to Administer > Site builing > Modules page and enable the TinyBrowser module.

  4. Go to Administer > Site configuration > TinyBrowser page, which is the module settings page.

    First, check the WYSIWYG editor settings. TinyBrowser checks the installation of the WYSIWYG editor modules and WYSIWYG editors and pick up the correct comibination when it first time installed. If the settings is correct, then you do not need to change it. If you use TinyBrowser without using any WYSIWYG editors, leave this selection to 'None'.

    Next, create profiles and assign them to user roles. As default, only admin user (UID=1) can use the TinyBrowser with maximum permissions. If you want authenticated users to use TinyBrowser, create a profile and assign the profile to authenticated (or any other) user role. We tried to make this settings and GUI as close or same as possible with the one for IMCE file browser. So if you are using IMCE, you are already familiar with this settings.

    TinyBrowser supports browsing of three file types, regular files, image files and media files. Thumbnail view and resize, rotate image features are available for image file type only. You can specify directories to be used for these file types.
    In addition you can assign directory quota for these directories. The quota value is applied for each directory. Once it reaches the quota limit, you can not upload files using TinyBrowser. TinyBrowser's upload panel shows the remaining size dynamically. This quota is applied not only to the files uploaded by TinyBrowser but also the files added to the directory or subdirectories by any means (FTP, etc).

    The last but important setting is the permission of operations. Permission of uploading, deleting and subfolder needs to be given carefully since they may cause the security risk.

Installation - setting of WYSIWYG editor modules

To use TinyBrowser with either TinyMCE, FCKeditor or CKEditor, some extra settings are required. Currently, TinyBrowser module supports the following combination of Drupal WYSIWYG editor modules and editors.
  1. TinyTinyMCE module + TinyMCE
  2. Wysiwyg module + TinyMCE
  3. FCKeditor module + FCKeditor
  4. Wysiwyg module + FCKeditor
  5. CKEditor module + CKEditor
  6. Wysiwyg module + CKEditor
Since the extra settings differs for all these cases, we will explain them for each cases.
  1. TinyTinyMCE module + TinyMCE

    Go to module settings page at Administer > Site configuration > TinyTinyMCE. The edit the TinyMCE.init script for the Advanced mode, and add the following one line. (if the line exists, then replace it)

    file_browser_callback: tinyBrowser

    Below is the example of the top part of tinyMCE.init script for Advanced mode after adding file_browser_callback parameter.
    1.   tinyMCE.init({
    2.     mode : "exact",
    3.     file_browser_callback: "tinyBrowser",  // Added Here!!!
    4.     init_instance_callback: "resizeEditorBox",
    5.     theme: "advanced",
    6.     convert_urls: flase,
    7.     plugins: "safari,pagebreak ....
    8.      :
    9.    theme_advanced_buttons1: "bold,italic,underline ...
    10.       :
    11.   });
    This line is case sensitive. Be sure to use "tinyBrowser", not "tinybrowser". Currently, TinyTinyMCE module supports IMCE and automatically adds 'file_browser_callback: "imceImageBrowser" if IMCE module exists. We needs to do the same thing manually for the TinyBrowser. Do not forget to enable toolbar icons for image/media/link files if there are not there.

  2. Wysiwyg module + TinyMCE

    Go to the module settins page at Administer > Site configuration > Wysiwyg. Then edit the input format which you assigned to use TinyMCE editor. Go to the Buttons and Plugins section and you should see a new checkbox 'TinyBrowser' is added there. Check the checkbox and save the settings.
    Do not forget to enable toolbar icons for image/media/link files if there are not there.

  3. FCKeditor module + FCKeditor

    This is a bit difficult steps. Currently, you should apply a patch to the FCKeditor modules main source file 'fckeditor.module' to use TinyBrowser. You can download the patch from the bottom of this page. The patch distributed now is for FCKeditor 6.x-1.4 and 6.x-2.1. For FCKeditor-6.x-1.4, a patch will update fckeditor.module file. For FCKeditor-6.x-2.1, there are two patch files and they updates fckeditor.module and fckeditor.admin.inc files.
    Once you applied the patch, go to the module settings pat at Administer > Site configuration > FCKeditor. Then go to the File browser settings section and you should see the TinyBrowser is added to the valid file browser list. Select TinyBrowser and save the settings. Besides, the directories fields below this file browser selection is not used for the TinyBrowser. If you want to use TinyBrowser's file uploader, do not forget to give the upload permission to the role who uses FCKeditor at User Permission page.
    Do not forget to enable toolbar icons for image/media/link files if there are not there.

  4. Wysiwyg module + FCKeditor

    Go to the module settins page at Administer > Site configuration > Wysiwyg. Then edit the input format which you assigned to use FCKeditor. Go to the Buttons and Plugins section and you should see a new checkbox 'TinyBrowser' is added there. Check the checkbox and save the settings. If you want to use TinyBrowser's file uploader, do not forget to give the upload permission to the role who uses FCKeditor at User Permission page.
    Do not forget to enable toolbar icons for image/media/link files if there are not there.

  5. CKEditor module + CKEditor

    Current version of CKEditor module has added the support for the TinyBrowser. So unlike the case of the FCKeditor module, no patch is required for the CKEditor module. Go to the module settings pat at Administer > Site configuration > CKEditor. Then go to the File browser settings section and you should see the TinyBrowser is added to the valid file browser list. Select TinyBrowser and save the settings. Besides, the directories fields below this file browser selection is not used for the TinyBrowser. If you want to use TinyBrowser's file uploader, do not forget to give the upload permission to the role who uses CKEditor at User Permission page.
    Do not forget to enable toolbar icons for image/media/link files if there are not there.

  6. Wysiwyg module + CKEditor

    Go to the module settins page at Administer > Site configuration > Wysiwyg. Then edit the input format which you assigned to use CKEditor. Go to the Buttons and Plugins section and you should see a new checkbox 'TinyBrowser' is added there. Check the checkbox and save the settings. If you want to use TinyBrowser's file uploader, do not forget to give the upload permission to the role who uses CKEditor at User Permission page.
    Do not forget to enable toolbar icons for image/media/link files if there are not there.

That's all for the installation and set-up of the TinyBrowser module. We will explain how to use TinyBrowser in the next page.


Problems?

If you have difficulty using TinyBrowser, please check this page first.
TinyBrowser (3) Troubleshooting
http://www.pixture.com/drupal/node/238


Related links

TinyBrowser (original author's site)
http://www.lunarvis.com/products/tinymcefilebrowserwithupload.php
TinyBrowser Google Group (support forum)
http://groups.google.com/group/tinybrowser

TinyMCE
http://tinymce.moxiecode.com
FCKeditor and CKEditor
http://ckeditor.com
TinyTinyMCE module
http://drupal.org/project/tinytinymce
FCKeditor module
http://drupal.org/project/fckeditor
CKEditor module
http://drupal.org/project/ckeditor
Wysiwyg module
http://drupal.org/project/wysiwyg

 

AttachmentSize
fckeditor-6.x-1.4.module.patch2.35 KB
fckeditor-6.x-2.1-module-tinybrowser-patch.tar.gz850 bytes
No votes yet

TinyBrowser (2) How to use

pict-drupal-module.png In this page, we explain how to use TinyBrowser step by step. TinyBrowser module is developed as an alternative to IMCE. Therefore, using TinyBrowser is basically same as using IMCE.

Use TinyBrowser with WYSIWYG editors

When you use TinyBrowser with WYSIWYG editors, it's almost same as the way IMCE is used.

First, to start TinyBrowser, you need to click on the image/media/link icon on the toolbar of the WYSIWYG editor. If you do not see these icons, then you need to configure your WYSIWYG editor. In this explanation, we are going to insert an image to the editor. So we click on the image icon of the toolbar.

ss-tinybrowser-step-1.png
When you click on the image icon, a small image setting window is displayed.

ss-tinybrowser-step-2.png
On this windows click on the small rectangle icon to start TinyBrowser. In case of FCKeditor, click on the 'Server Browser' button instead of an icon.

Now, TinyBrowser is started and it's window is displayed. As default, file browser panel is displayed. In case of image file browsing, list of thumbnail images are displayed.

ss-tinybrowser-step-3.png
When you click on the image you want to insert to the editor, TinyBrowser window is closed and returnsto the small image setting window again, but this time, you should see the selected image displayed in the window.

ss-tinybrowser-step-4.png
With this image setting window, you can specify image tag related parameters such as Alt, Title, Align attributes. When it's ready to insert
the image to the editor, click on the "Insert" button. The small image setting window is closed and returns to the editor. You will see that the selected image is inserted to the editor.

ss-tinybrowser-step-5.png


Use TinyBrowser with plain textarea

If you are not using any WYSIWYG editor, you can still use TinyBrowser with plain textarea. Go to Administer > Site configuration > TinyBrowser. In the general setting section, there's a text field for spacifying the field ID of the plain textarea with which you want to use TinyBrowser. In case of regular node creation form, "edit-body" is the textarea of the node body. So just enter "edit-body" there.
Once you do this, you will see that the link "Insert image or link" right below the textarea.

ss-tinybrowser-step-6.png
Clicking 'image' will invoke TinyBrowser with image file mode, and 'link' for the TinyBrowser with regular file mode. Then, once you select an image or file, image tag or anchor tag of the selected item is inserted to the textarea.


Use TinyBrowser at user account page

When you enable the permission of "Use TinyBrowser at user account page" in the profile settings of TinyBrowser, "TinyBrowser" tag menu is added to the user account page. When you select the "TinyBrowser" menu, three sub links are displayed (image, media and file). Clicking these link will invoke TinyBrowser with corresponding file mode.

ss-tinybrowser-step-7.png
In this case, selected image/media file will be displayed in a new browser's window, and selected regular file will be download.


Important Note

Regarding the bugs and/or problems of the main functions of TinyBrowser, we may not be able to fix it since we are not the developer of the TinyBrowser itself. Especially, regarding the Flash based uploader, we do not have the source of the Flash file, so it is impossible for us to deal with any issues related with this Flash file.

Please address the bugs, problems, feature requests for the main functions of TinyBrowser to the support forum at TinyBrowser Google Group, which is maintained by the developer of the TinyBrowser.

TinyBrowser Google Group
http://groups.google.com/group/tinybrowser


 

No votes yet

TinyBrowser (3) Troubleshooting

pict-drupal-module.png This page explains about the troubleshooting of TinyBrowser module.

Since TinyBrowser uses JavaScript, cookie, session, etc., there are some places we want to you to check first before reporting problems/bugs. So please try do the following steps when you have problem of using TinyBrowser.

Troubleshooting

  1. Check issues for the TinyBrowser project page and check if you can find similar/same issues you have there.
    http://drupal.org/project/issues/tinybrowser

  2. Make sure that you installed TinyBrowser, WYSIWYG editor module and WYSIWYG editor to the proper directory.

    TinyBrowser module should be installed to the (drupal-root)/sites/all/modules directory, as well as WYSIWYG editor modules. Directory for installing WYSIWYG editor depends on the WYSIWYG editor module you use.

  3. Check any problem at TinyBrowser module settings page.
    Go to Administer > Site configuration > TinyBrowser page and check if the WYSIWYG editor section has any error messages or not. Make sure that the correct WYSIWYG editor is selected there. If the selected editor does not match the actual WYSIWYG editor you are using, you can still open up the TinyBrowser popup window but the image selected will not be inserted back to the editor.

  4. Check and make sure that $cookie_domain is defined in the settings.php file for your site.
    If you do not define the $cookie_domain, you will end up with a blank TinyBrowser window.

  5. Check and make sure that the PHP safe_mode is OFF
    If you can create a small PHP script and run at the server, you will see all the PHP settings of your server.
    1. <?php
    2.  phpinfo();
    3. ?>
    Search the safe_mode under PHP core configuration section in the result.

  6. Check and make sure no Javascript aggregator/optimizer
    TinyBrowser work neighter Javascript Aggregator module nor Optimize Javascript file setting ON at Administer > Site Configuration > Performance page. If you switch from ON to OFF, be sure to clear Drupal cache and web browser's cache.

  7. If you are using either FCKeditor with FCKeditor module or CKEditor with CKEditor module, go to the module settings page and check if the TinyBrowser is selected at the File browser settings section.

  8. If you are using FCKeditor, CKEditor or TinyMCE with Wysiwyg module, check if the TinyBrowser plugin checkbox is checked at Buttons and Plugins section of the Wysiwyg modules settings.

  9. Be sure that you have added proper toolbar icons for image/media/file browsing. You do not have to enable all types, just enable the button for only the types you want to use.

  10. Clear the Drupal cache
    Go to Administer > Site Configuration > Performance page and then click the button Clear cached data.

  11. Clear the Web browser's cache on your local PC

  12. Restart the Web browser on your local PC

  13. Open error console or use any other method to collect Javascript errors and try to start TinyBrowser. If you see a Javascript error related with TinyBrowser, note the detail error and report it to us.

  14. Check the watchdog log
    Go to Administer > Reports > Recent log entries page and check if you can see any error that seems to be related with TinyBrowser. If you find any, report them to us. or if you see any log whose type is TinyBrowser, report that to us too.

  15. If you have access to the Drupal data base table 'variable' (or with some prefix such as 'my_variable', please issue the following SQL command and report the out to us.
    1. SELECT * FROM variable WHERE name LIKE '%tinybrowser%';
    You can find your database tabel prefix in the settings.php file for your site. ($db_prefix)

  16. Enable inline plain textarea mode and check if it works or not.
    Go to Administer > Site configuration > TinyBrowser page and General settings section. Then, enter edit-body to the text field of 'Enable inline image/file insertion into plain textareas'.
    Then go to create contents page (any content type) and you should see the 'insert image or link' small text right below the content Body's textarea.
    First disable the WYSIWYG editor and then click on the 'image' or 'link' button. This will invoke the TinyBrowser with standalone mode. Please check if this works perfectly or fails just like the TinyBrowser invoked from inside the WYSIWYG editor.

Please collect as much information as possible using the procedures above, and report to us at Issues for TinyBrowser forum at drupal.org.

We are now collecting any many troubleshooting information as possible to make this troubleshooting page better.

Thanks,

 

Your rating: None Average: 3 (1 vote)

Star Rating

Star Rating is a simple module that provides star rating field and display formatter using Drupal 7's Field Type API.

ss-starrate.png
Unlike Fivestar module and other voting/rating module, it supports neither end user voting nor nice AJAX interface. It is inteded for the rating only by the author of the article (node). Of course, you may be able to do this with Fivestar module and other voting/rating modules, but unlike most of them, it does not require other modules such as voting API module. It's born to be simple but good enough for those who want star rating only by authors.

For example, if you are creating a restaurant review web site and you want to add three 5 star ratings (food, price and service) with different icon type for each rating within a node, then this module would be the best match.

Features



Installation

Just like any other modules, extract the archive at (Drupal-root)/sites/all/modules directory. Then enable the module from Modules admin page (/admin/modules).


How to use

To use Star Rating module, you need to create a field for the star rating. To do this, go to Content types admin page (/admin/structure/types) and edit/create a content type to which you want to add star rating field.

Go to the Manage Field tab and add a new filed with "Star rating" field type selected. If you wish to use existing integer or list(numeric) field, you can do so. When you add a field of the "Star rating" field type, the "Star rating" widget is automatically selected. However, if you use either integer or list(numeric), be sure to select "Star rating" for the widget.

ss-starrating-1.png
Once you click the "Save" button, the field settings tab is displayed. Please choose the maximum rating value for the field there. Star Rating module supports up to 10 maximum rating value.

ss-starrating-2.png
Once you press the "Save field settings" button, the Review settings page is displayed and you can select the default rating value if you wish. Please keep in mind that Star Rating module does not support multiple instances of a field within the same content. (It's meaningless isnt it?).

ss-starrating-3.png
Now the series of adding field steps is completed, please select the Manage Display tab.

ss-starrating-6.png
At the Manage Display tab, you can select some options including icon type and color to be used for the field. You can even assign different icon type and color for each display mode (default, full, teaser) if you wish.
ss-starrating-5.png
That's all. When you create a new article and enter the rating value, you will see the rating icons of your choice instead of integer values.
ss-starrating-7.png

Althogh the integer value of each field is replaced with icons and not displayed, the value is included and hidden in the HTML code so that the integer value is used when you copy and paste the web site contents to text editor, or when you use voice reading feature.


Adding/changing icons

Currently, there's no UI for adding/changing icons. You need to manually replace icon image file (.png) and CSS file (.css) in the icons directory. For this, you can use the 'Custom' icon type. There are custom.css and custom.png file in the icons sub-directory but they are just place holders (they are identical with star.css and star.png). All you need to do is create your own custom.css and custom.png and replace them with your own files. Please take a moment and read the MEMO.txt file in the icons directory for the additional information.


Downloading Star Rating module

Please download it from the project page at Drupal.org.

Star Rating module
http://drupal.org/project/starrating

 

Your rating: None Average: 3.9 (45 votes)