تنبيه الإداريين بالمرفقات المراقبة
 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
! بدعم ورعاية: مملكة البى إتش بى للخدمات التقنية (www.phpkd.net) !
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Note: هذا المنتج تم طلبه من قبل kevinh كعمل برمجى خاص مدفوع الأجر. تم تنفيذ المنتج وإرساله للعميل قبل عدة أشهر. ونظراً لأن كافة أعمالى البرمجية أقوم بترخيصها وفقاً لأحد التراخيص الحرة وتحديداً Creative Commons - Attribution-Noncommercial-Share Alike 3.0, فقد تم نشر المنتج مجاناً للجميع لتعم الفائدة.


الاسم: تنبيه الإداريين بالمرفقات المراقبة - الإصدار: 3.8.100

الوصف: هذا المنتج يسمح بمراسلة الإداريين عند رفع مرفقات جديدة مراقبة.


متوافق مع: جميع إصدارات المنتدى 3.6/3.7/3.8 بكافة فروعها.


متطلبات المنتج:

• لابد من تنصيب المنتج التالى أولاً:
  مراقبة المرفقات إفتراضياً - التحكم بالمرفقات قبل العرض

المزايا والخواص:

• يعتمد على متغيرات اللغات بشكل كامل.
• يعمل بشكل تلقائى كلياً.
• مدعم رسمياً.
• دقيق فى برمجياً.
• مبرمج بإحترافية عالية.
• يتبع نفس آليات المنتدى الإفتراضية وستخدم كافة تقنياته بشكل كامل.
• يمكن التحكم بخيار "تنبيه الإداريين بالمرفقات المراقبة" لكل قسم بالمنتدى على حدى.
• يمكن التحكم بخيار "تلقي بريد إلكترونى عند رفع مرفق جديد مراقب" لكل مشرف/مراقب/إدارى على حدى.
• يمكن الإختيار ما بين خيارين: إما "مراسلة المشرفين" فقط أو "مراسلة المشرفين والمراقبين والإداريين".

خطوات التنصيب:

1. قم برفع الملف "bitfield_modattachstaffnotify.xml" إلى مكانه "/includes/xml/".
2. قم بتنفيذ التعديل التالى:
   قم بفتح الملف "includes/class_dm_threadpost.php" وابحث بداخله عن الأكواد التالية:
   
   كود:

   ---

           function email_moderators($fields)

   ---

   أضف فوقها مباشرة الأكواد التالية:
   
   كود:

   ---

           /**
        * Fetches the amount of moderated attachments associated with a posthash and user
        *
        * @param        string        Post hash
        * @param        integer        User ID associated with post hash (-1 means current user)
        *
        * @return        integer        Number of attachments
        */
        function fetch_mod_attachment_count($postid, $userid = -1)
        {
                if ($userid == -1)
                {
                        $userid = $this->fetch_field('userid', 'post');
                }
                $userid = intval($userid);

                $attachcount = $this->dbobject->query_first("
                        SELECT COUNT(*) AS count
                        FROM " . TABLE_PREFIX . "attachment
                        WHERE postid = '$postid'
                                AND userid = $userid
                                AND visible != 1
                ");

                return intval($attachcount['count']);
        }

        /**
        * Fetches the moderated attachments associated with a posthash and user
        *
        * @param        string        Post hash
        * @param        integer        User ID associated with post hash (-1 means current user)
        *
        * @return        array Moderated attachments IDs
        */
        function fetch_mod_attachment($postid, $userid = -1)
        {
                if ($userid == -1)
                {
                        $userid = $this->fetch_field('userid', 'post');
                }
                $userid = intval($userid);

                $attachs = $this->dbobject->query_read_slave("
                        SELECT attachmentid, filename
                        FROM " . TABLE_PREFIX . "attachment
                        WHERE postid = '$postid'
                                AND userid = $userid
                                AND visible != 1
                ");

                $modattach = array();
                while ($attach = $this->dbobject->fetch_array($attachs))
                {
                        $modattach[$attach['attachmentid']] = array('attachmentid' => $attach['attachmentid'], 'filename' => $attach['filename'], 'postid' => $attach['postid'], 'dateline' => $attach['dateline']);
                }

                return $modattach;
        }

        function attach_email_moderators($fields, $attachcount, $attachs)
        {
                if ($this->info['skip_moderator_email'] OR !$this->info['forum'] OR in_coventry($this->fetch_field('userid', 'post'), true))
                {
                        return;
                }

                $mod_emails = fetch_moderator_modattach_emails($fields, $this->info['forum']['parentlist'], $newpost_lang);

                if (!empty($mod_emails))
                {
                        $foruminfo = $this->info['forum'];
                        $foruminfo['title_clean'] = unhtmlspecialchars($foruminfo['title_clean']);

                        $threadinfo = fetch_threadinfo($this->fetch_field('threadid'));

                        $email = ($this->info['user']['email'] ? $this->info['user']['email'] : $this->registry->userinfo['email']);
                        $browsing_user = $this->registry->userinfo['username'];

                        // ugly hack -- should be fixed in the future
                        $this->registry->userinfo['username'] = unhtmlspecialchars($this->info['user']['username'] ? $this->info['user']['username'] : $this->registry->userinfo['username']);

                        $post = array_merge($this->existing, $this->post);
                        if (!$post['postid'])
                        {
                                $post['postid'] = $this->thread['firstpostid'];
                        }

                        require_once(DIR . '/includes/functions_misc.php');

                        foreach ($mod_emails AS $toemail)
                        {
                                if ($toemail != $email)
                                {
                                        if ($threadinfo['prefixid'])
                                        {
                                                // need prefix in correct language
                                                $threadinfo['prefix_plain'] = fetch_phrase(
                                                        "prefix_$threadinfo[prefixid]_title_plain",
                                                        'global',
                                                        '',
                                                        false,
                                                        true,
                                                        isset($newpost_lang["$toemail"]) ? $newpost_lang["$toemail"] : 0,
                                                        false
                                                ) . ' ';
                                        }
                                        else
                                        {
                                                $threadinfo['prefix_plain'] = '';
                                        }

                                        $attachdetails = "";
                                        foreach ($attachs as $attach)
                                        {
                                                $attachdetails .= " * ID: " . $attach['attachmentid'] . ", Name: " . $attach['filename'] . "\n";
                                        }

                                        eval(fetch_email_phrases('moderator_attach', iif(isset($newpost_lang["$toemail"]), $newpost_lang["$toemail"], 0)));
                                        vbmail($toemail, $subject, $message);
                                }
                        }

                        // back to normal
                        $this->registry->userinfo['username'] = htmlspecialchars_uni($browsing_user);
                }
        }

   ---

   ** قم بحفظ تعديلات الملف "includes/class_dm_threadpost.php" وإعادة رفعه لمكانه مجدداً مع السماح بإستبدال القديم. **
   
   
   قم بفتح الملف "includes/functions_newpost.php" وابحث بداخله عن الأكواد التالية:
   
   كود:

   ---

   /**
* Fetches the email addresses of moderators to email when there is a new post
* or new thread in a forum.
*
* @param        string|array        A string or array of dbfields to check for email addresses; also doubles as mod perm names
* @param        string|array        A string (comma-delimited) or array of forum IDs to check
* @param        array                        (By reference) An array of languageids associated with specific email addresses returned
*
* @return        array                        Array of emails to mail
*/
function fetch_moderator_newpost_emails($fields, $forums, &$language_info)

   ---

   
   أضف فوقها مباشرة الأكواد التالية:
   
   كود:

   ---

   /**
* Fetches the email addresses of moderators to email when there is a new moderated attachments in a forum.
*
* @param        string|array        A string or array of dbfields to check for email addresses; also doubles as mod perm names
* @param        string|array        A string (comma-delimited) or array of forum IDs to check
* @param        array                        (By reference) An array of languageids associated with specific email addresses returned
*
* @return        array                        Array of emails to mail
*/
function fetch_moderator_modattach_emails($fields, $forums, &$language_info)
{
        global $vbulletin;

        $language_info = array();

        if (!is_array($fields))
        {
                $fields = array($fields);
        }

        // figure out the fields to select and the permissions to check
        $field_names = '';
        $mod_perms = array();
        foreach ($fields AS $field)
        {
                if ($permfield = intval($vbulletin->bf_misc_modattachstaffnotify["$field"]))
                {
                        $mod_perms[] = "(moderator.modattachstaffnotify & $permfield)";
                }

                $field_names .= "$field, ' ',";
        }

        if (sizeof($fields) > 1)
        {
                // kill trailing comma
                $field_names = 'CONCAT(' . substr($field_names, 0, -1) . ')';
        }
        else
        {
                $field_names = reset($fields);
        }

        // figure out the forums worth checking
        if (is_array($forums))
        {
                $forums = implode(',', $forums);
        }
        if (!$forums)
        {
                return array();
        }

        $modattachemail = '';

        $moderators = $vbulletin->db->query_read_slave("
                SELECT $field_names AS modattachemail
                FROM " . TABLE_PREFIX . "forum
                WHERE forumid IN (" . $vbulletin->db->escape_string($forums) . ")
        ");
        while ($moderator = $vbulletin->db->fetch_array($moderators))
        {
                $modattachemail .= ' ' . trim($moderator['modattachemail']);
        }

        if (empty($modattachemail) OR $vbulletin->options['modattachstaffnotify_emailto'] == 1)
        {
                // get a list of super mod groups
                $smod_groups = array();
                foreach ($vbulletin->usergroupcache AS $ugid => $groupinfo)
                {
                        if ($groupinfo['adminpermissions'] & $vbulletin->bf_ugp_adminpermissions['ismoderator'])
                        {
                                // super mod group
                                $smod_groups[] = $ugid;
                        }
                }
        }

        if ($mod_perms)
        {
                $mods = $vbulletin->db->query_read_slave("
                        SELECT DISTINCT user.email, user.languageid
                        FROM " . TABLE_PREFIX . "moderator AS moderator
                        LEFT JOIN " . TABLE_PREFIX . "user AS user USING(userid)
                        WHERE
                                (
                                        (moderator.forumid IN (" . $vbulletin->db->escape_string($forums) . ") AND moderator.forumid <> -1)
                                        " . (!empty($smod_groups) ? "OR (user.usergroupid IN (" . implode(',', $smod_groups) . ") AND moderator.forumid = -1)" : '') . "
                                )
                                AND (" . implode(' OR ', $mod_perms) . ")
                ");
                while ($mod = $vbulletin->db->fetch_array($mods))
                {
                        $language_info["$mod[email]"] = $mod['languageid'];
                        $modattachemail .= ' ' . $mod['email'];
                }
        }

        $emails = preg_split('#\s+#', trim($modattachemail), -1, PREG_SPLIT_NO_EMPTY);
        $emails = array_unique($emails);

        return $emails;
}

   ---

   ** قم بحفظ تعديلات الملف "includes/functions_newpost.php" وإعادة رفعه لمكانه مجدداً مع السماح بإستبدال القديم. **
   
   
3. قم بإستيراد ملف المنتج من لوحة تحكم إدارة المنتدى.
4. انتهى :).

خيارات التحكم:

• لوحة تحكم إدارة المنتدى -> خيارات المنتدى -> تنبيه الإداريين بالمرفقات المراقبة
• لوحة تحكم إدارة المنتدى -> المنتديات والمراقبين -> عرض كافة المراقبين -> من جانب أى مشرف/مراقب انقر على "تعديل التراخيص" -> تلقي بريد إلكترونى عند رفع مرفق جديد مراقب
• لوحة تحكم إدارة المنتدى -> المنتديات والمراقبين -> التحكم بأقسام المنتدى -> إختيار القسم -> عناوين البريد الإلكترونى للمراسلة عند رفع مرفقات جديدة مراقبة

الترخيص:

• Creative Commons - Attribution-Noncommercial-Share Alike 3.0

ساعد بـ:

• اقتراحاتك لتطوير المنتج.
• مساهماتك بتحديثات وترقيات المنتج وتطوير بعض المزايا الجديدة.
• ترجماتك للمنتج للغات أخرى غير متوفرة لتعم الفائدة بقطاع أكبر من المستخدمين (حقوق الترجمة تحفظ لصاحبها).
• بنشر المنتج. أجل، لك كامل الحرية فى نشر المنتج كما هو أينما تشاء.

إشكاليات مكتشفة:

• لا شئ حتى الآن.

السجل:

• v3.8.100 14/01/2009 02:00 PM GMT: أول إصدار عام للنشر.

Screen Shots:

• متوفرة بالأسفل.

ملاحظات تقنية:

• الملفات الجديدة: 1
• الملحقات البرمجية الجديدة: 6
• العبارات الجديدة: 10
• القوالب الجديدة: 0
• تعديلات القوالب: 0
• إعدادات المنتدى الجديدة: 2
• إعدادات المنتدى الجديدة: 1
• الصلاحيات الجديدة لمجموعات الأعضاء: 0
• الصلاحيات الجديدة للمشرفين: 1
• الصلاحيات الجديدة للإداريين: 0
• الإعدادات الجديدة للأقسام: 1
• الجداول الجديدة لقاعدة البيانات: 0
• تعديلات قاعدة البيانات: 2
• المهام المجدولة الجديدة: 0
  -----------------
• مستوى التنصيب: سهل
• متوسط وقت التنصيب: 30~50 ثانية
  

دعم المنتج:

• جزيل الشكر مقدماً لداعمى المنتج والمبرمجين الأحرار، يمكن دعم المنتج بإرسال أى مبلغ ترغب بدعم المنتج والمبرمجين الأحرا به من خلال Moneybookers على البريد التالى:
  
  كود:

  ---

  freelancers@phpkd.net

  ---