Limit Summary Length
7:25 pm
Tags: eFiction, eFiction 3.0, limit summary length, PHP, Web Design
Mood: na

Description: Places a mandatory limit on how long a summary can be. If the summary exceeds the limit, the user is kicked back to the preview screen with the notice that they have to shorten their summary.

Summary length is controlled in your admin settings, under "Submissions." If a limit is in place, a small notice appears above your summary field on story submissions notifying your users of the limit. If you turn it off, nothing appears.

To turn it on, simply type in a length. (I suggest at least 750 - 1000 characters.) To turn it off, set it to 0.

This was originally a 2.0 mod, but frankly -- it's a much easier, neater, and more sophisticated mod on 3.0.

As usual, my line numbers are only there as a reference to put you in the general ballpark. They will likely change as you progress through the mod.

This always bears repeating: Please be sure to backup your files and database before you begin this or any other mod.

Requirements: eFiction 3.2.1

Difficulty: Easy - Intermediate (Depends on how well you follow my instructions.)

Files Involved:

    admin/settings.php
    includes/storyform.php
    stories.php
    languages/en.php
    languages/en_admin.php
    1 Database Modification

Modification History:
- 22 March, 2007 -- Mod Released

Modification & Support: eFiction.org

Instructions:


Datbase Alteration:

General information: (For phpMyAdmin, etc.)
Table to Alter: fanfiction_settings

    Name: summarylimit
    Datatype: INT
    Length: 11
    Null: Not Null
    Default: 0
    After: minwords

SQL Statement:
PLAIN TEXT
MySQL:

    ALTER TABLE `fanfiction_settings` ADD `summarylimit` INT( 11 ) NOT NULL DEFAULT '0' AFTER `minwords` ;



Open: admin/settings.php
Line 1; look for this:
PLAIN TEXT
PHP:

    <?php

After add this:
PLAIN TEXT
PHP:

    // Mod: Limit Summary Length ----------------------------------



Look for this: (Line 110)
PLAIN TEXT
PHP:

    $maxwords = isNumber($_POST['newmaxwords']) ? $_POST['newmaxwords'] : 0;

After that, add this:
PLAIN TEXT
PHP:

    // Limit Summary Length MOD --------
            $summarylimit = isNumber($_POST['newsummarylimit']) ? $_POST['newsummarylimit'] : 0;



Look for this: (line 121)
PLAIN TEXT
PHP:

    $result = dbquery("UPDATE ".$settingsprefix."fanfiction_settings SET submissionsoff = '$submissionsoff', autovalidate = '$autovalidate', coauthallowed = '$coauthallowed', store = '$store', storiespath = '$storiespath', minwords = '$minwords', maxwords = '$maxwords', imageupload = '$imageupload', imageheight = '$imageheight', imagewidth = '$imagewidth', roundrobins = '$roundrobins', allowseries = '$allowseries' WHERE sitekey = '$sitekey'");

Inside that, look for
PLAIN TEXT
PHP:

    maxwords = '$maxwords',

After that, add this:
PLAIN TEXT
PHP:

    summarylimit = '$summarylimit',



Look for this: (line 257)
PLAIN TEXT
PHP:

    <label for=\"newstoriespath\">"._STORIESPATH.": </label> <input type=\"text\" class=\"textbox=\" name=\"newstoriespath\" value=\"$storiespath\"/> <a HREF=\"#\" class=\"pophelp\">[?]<span>"._HELP_STORIESPATH."</span></a>

AFTER the closing div tag, but BEFORE the semicolon, add this:
PLAIN TEXT
PHP:

    <!-- Limit Summary Length MOD -->
                    <div><label for=\"newsummarylimit\">"._SUMLIMIT.": </label> <input type=\"text\" class=\"textbox=\" name=\"newsummarylimit\" value=\"$summarylimit\" size=\"7\"/> <a HREF=\"#\" class=\"pophelp\">[?]<span>"._HELP_SUMMARYLIMIT."</span></a><br /><br /></div>



Open: includes/storyform.php
Line 1; look for this:
PLAIN TEXT
PHP:

    <?php

After add this:
PLAIN TEXT
PHP:

    // Mod: Limit Summary Length ----------------------------------



Line 33, look for this:
PLAIN TEXT
PHP:

    global $admin, $allowed_tags, $multiplecats, $tableprefix, $useruid, $roundrobins, $catlist, $adminloggedin, $coauthallowed, $tinyMCE, $action, $sid;

Inside that, look for
PLAIN TEXT
PHP:

    $allowed_tags,

After that, add this:
PLAIN TEXT
PHP:

    $summarylimit,



Look for this: (Line 70)
PLAIN TEXT
PHP:

    $output .= "<p><label for=\"summary\">"._SUMMARY.":</label> ".($preview && !$summary ? "<span style=\"font-weight: bold; color: red\">*</span>" : "")."<br /><textarea class=\"textbox\" rows=\"6\" name=\"summary\" id=\"summary\" cols=\"58\">$summary</textarea>";

ABOVE that, add this:
PLAIN TEXT
PHP:

    // Limit Summary Length MOD --------

Inside that line, look for this:
PLAIN TEXT
PHP:

    ($preview && !$summary ? "<span style=\"font-weight: bold; color: red\">*</span>" : "").

After, add:
PLAIN TEXT
PHP:

    ($summarylimit ? ""._SUMMARYLIMIT."" : "").



Open: stories.php
Line 1; look for this:
PLAIN TEXT
PHP:

    <?php

After add this:
PLAIN TEXT
PHP:

    // Mod: Limit Summary Length ----------------------------------



Find: (Line 76)
PLAIN TEXT
PHP:

    global $autovalidate, $sid, $action, $sid, $store, $tpl, $storiespath, $admin, $sitename, $siteemail, $allowed_tags, $level, $admincats, $alertson, $dateformat, $url, $tableprefix, $minwords, $maxwords, $useruid, $userpenname, $charlist, $catlist, $classtypelist;

Inside that, look for this:
PLAIN TEXT
PHP:

    $maxwords,

After that, add:
PLAIN TEXT
PHP:

    $summarylimit,



Find: (Line: 140)
PLAIN TEXT
PHP:

    if(find_naughty($title)) $failed .= "<br />"._NAUGHTYWORDS;

After add:
PLAIN TEXT
PHP:

    // Limit Summary Length MOD --------
            if($summarylimit && strlen($summary)> "$summarylimit") $failed .= "<br />"._SUMMARYTOOLONG;



Open: languages/en.php (or your language)

Look for this at the bottom:
PLAIN TEXT
PHP:

    ?>

BEFORE that, add this:
PLAIN TEXT
PHP:

    // Limit Summary Length MOD --------
    define ("_SUMMARYLIMIT", "<small>(Limit: $summarylimit characters)</small>");
    define ("_SUMMARYTOOLONG", "Your summary is too long.  Summaries must be no longer than $summarylimit characters, including HTML and spaces.");



Open: languages/en_admin.php (or your language)

Look for this at the bottom:
PLAIN TEXT
PHP:

    ?>

BEFORE that, add this:
PLAIN TEXT
PHP:

    // Limit Summary Length MOD --------
    define ("_SUMLIMIT", "Maximum Summary Length");
    define ("_HELP_SUMMARYLIMIT", "This allows you to set the maximum character count in summaries.  This counts all characters including spaces, special characters, HTML, and regular text.  Set this to 0 to impose no limits on summary length.  Recommended: 750 - 1000 characters.");



Save, upload, and enjoy!