display library * @todo complete the missing phpdoc the correct order should be */ use ChamiloSession as Session; use Doctrine\Common\Collections\Criteria; define('FORUM_NEW_POST', 0); get_notifications_of_user(); $htmlHeadXtra[] = api_get_jquery_libraries_js(array('jquery-ui', 'jquery-upload')); $htmlHeadXtra[] = ''; // The next javascript script is to manage ajax upload file $htmlHeadXtra[] = " "; // Recover Thread ID, will be used to generate delete attachment URL to do ajax $threadId = isset($_REQUEST['thread']) ? intval($_REQUEST['thread']) : 0; $forumId = isset($_REQUEST['forum']) ? intval($_REQUEST['forum']) : 0; // The next javascript script is to delete file by ajax $htmlHeadXtra[] = ''; /** * This function handles all the forum and forum categories actions. This is a wrapper for the * forum and forum categories. All this code code could go into the section where this function is * called but this make the code there cleaner. * @param int $lp_id Learning path Id * * @return void * @author Patrick Cool , Ghent University * @author Juan Carlos Raña Trabado (return to lp_id) * @version may 2011, Chamilo 1.8.8 */ function handle_forum_and_forumcategories($lp_id = null) { $action_forum_cat = isset($_GET['action']) ? $_GET['action'] : ''; $get_content = isset($_GET['content']) ? $_GET['content'] : ''; $post_submit_cat = isset($_POST['SubmitForumCategory']) ? true : false; $post_submit_forum = isset($_POST['SubmitForum']) ? true : false; $get_id = isset($_GET['id']) ? intval($_GET['id']) : ''; $forum_categories_list = get_forum_categories(); //Verify if forum category exists if (empty($forum_categories_list)) { $get_content = 'forumcategory'; } // Adding a forum category if (($action_forum_cat == 'add' && $get_content == 'forumcategory') || $post_submit_cat) { show_add_forumcategory_form(array(), $lp_id); //$lp_id when is called from learning path } // Adding a forum if ((($action_forum_cat == 'add' || $action_forum_cat == 'edit') && $get_content == 'forum') || $post_submit_forum) { if ($action_forum_cat == 'edit' && $get_id || $post_submit_forum) { $inputvalues = get_forums($get_id); } else { $inputvalues = array(); } show_add_forum_form($inputvalues, $lp_id); } // Edit a forum category if (($action_forum_cat == 'edit' && $get_content == 'forumcategory') || (isset($_POST['SubmitEditForumCategory'])) ? true : false) { $forum_category = get_forum_categories($get_id); show_edit_forumcategory_form($forum_category); } // Delete a forum category if ($action_forum_cat == 'delete') { $id_forum = intval($get_id); $list_threads = get_threads($id_forum); for ($i = 0; $i < count($list_threads); $i++) { deleteForumCategoryThread('thread', $list_threads[$i]['thread_id']); $link_info = GradebookUtils::is_resource_in_course_gradebook(api_get_course_id(), 5, intval($list_threads[$i]['thread_id']), api_get_session_id()); if ($link_info !== false) { GradebookUtils::remove_resource_from_course_gradebook($link_info['id']); } } $return_message = deleteForumCategoryThread($get_content, $get_id); Display::display_confirmation_message($return_message, false); } // Change visibility of a forum or a forum category. if ($action_forum_cat == 'invisible' || $action_forum_cat == 'visible') { $return_message = change_visibility($get_content, $get_id, $action_forum_cat); Display::display_confirmation_message($return_message, false); } // Change lock status of a forum or a forum category. if ($action_forum_cat == 'lock' || $action_forum_cat == 'unlock') { $return_message = change_lock_status($get_content, $get_id, $action_forum_cat); Display::display_confirmation_message($return_message, false); } // Move a forum or a forum category. if ($action_forum_cat == 'move' && isset($_GET['direction'])) { $return_message = move_up_down($get_content, $_GET['direction'], $get_id); Display::display_confirmation_message($return_message, false); } } /** * This function displays the form that is used to add a forum category. * * @param array $inputvalues (deprecated, set to null when calling) * @param int $lp_id Learning path ID * * @author Patrick Cool , Ghent University * @author Juan Carlos Raña Trabado (return to lp_id) * @version may 2011, Chamilo 1.8.8 */ function show_add_forumcategory_form($inputvalues = array(), $lp_id) { $gradebook = Security::remove_XSS($_GET['gradebook']); // Initialize the object. $form = new FormValidator('forumcategory', 'post', 'index.php?gradebook='.$gradebook.'&'.api_get_cidreq()); // hidden field if from learning path $form->addElement('hidden', 'lp_id', $lp_id); // Setting the form elements. $form->addElement('header', '', get_lang('AddForumCategory')); $form->addElement('text', 'forum_category_title', get_lang('Title'), array('autofocus')); $form->addElement( 'html_editor', 'forum_category_comment', get_lang('Description'), null, array('ToolbarSet' => 'Forum', 'Width' => '98%', 'Height' => '200') ); $form->addButtonCreate(get_lang('CreateCategory'), 'SubmitForumCategory'); // Setting the rules. $form->addRule('forum_category_title', get_lang('ThisFieldIsRequired'), 'required'); // The validation or display if ($form->validate()) { $check = Security::check_token('post'); if ($check) { $values = $form->exportValues(); store_forumcategory($values); } Security::clear_token(); } else { $token = Security::get_token(); $form->addElement('hidden', 'sec_token'); $form->setConstants(array('sec_token' => $token)); $form->display(); } } /** * This function displays the form that is used to add a forum category. * * @param array $inputvalues * @param int $lp_id * @return void HTML * * @author Patrick Cool , Ghent University * @author Juan Carlos Raña Trabado (return to lp_id) * * @version may 2011, Chamilo 1.8.8 */ function show_add_forum_form($inputvalues = array(), $lp_id) { $_course = api_get_course_info(); $gradebook = Security::remove_XSS($_GET['gradebook']); // Initialize the object. $form = new FormValidator('forumcategory', 'post', 'index.php?gradebook='.$gradebook.'&'.api_get_cidreq()); // The header for the form if (!empty($inputvalues)) { $form_title = get_lang('EditForum'); } else { $form_title = get_lang('AddForum'); } $session_header = isset($_SESSION['session_name']) ? ' ('.$_SESSION['session_name'].') ' : ''; $form->addElement('header', $form_title.$session_header); // We have a hidden field if we are editing. if (!empty($inputvalues) && is_array($inputvalues)) { $my_forum_id = isset($inputvalues['forum_id']) ? $inputvalues['forum_id'] : null; $form->addElement('hidden', 'forum_id', $my_forum_id); } $lp_id = intval($lp_id); // hidden field if from learning path $form->addElement('hidden', 'lp_id', $lp_id); // The title of the forum $form->addElement('text', 'forum_title', get_lang('Title'), array('autofocus')); // The comment of the forum. $form->addElement( 'html_editor', 'forum_comment', get_lang('Description'), null, array('ToolbarSet' => 'Forum', 'Width' => '98%', 'Height' => '200') ); // Dropdown list: Forum categories $forum_categories = get_forum_categories(); foreach ($forum_categories as $key => $value) { $forum_categories_titles[$value['cat_id']] = $value['cat_title']; } $form->addElement('select', 'forum_category', get_lang('InForumCategory'), $forum_categories_titles); $form->applyFilter('forum_category', 'html_filter'); if ($_course['visibility'] == COURSE_VISIBILITY_OPEN_WORLD) { // This is for horizontal $group = array(); $group[] = $form->createElement('radio', 'allow_anonymous', null, get_lang('Yes'), 1); $group[] = $form->createElement('radio', 'allow_anonymous', null, get_lang('No'), 0); $form->addGroup($group, 'allow_anonymous_group', get_lang('AllowAnonymousPosts'), ' '); } $form->addButtonAdvancedSettings('advanced_params'); $form->addElement('html', ''); // The OK button if (isset($_GET['id']) && $_GET['action'] == 'edit') { $form->addButtonUpdate(get_lang('ModifyForum'), 'SubmitForum'); } else { $form->addButtonCreate(get_lang('CreateForum'), 'SubmitForum'); } // setting the rules $form->addRule('forum_title', get_lang('ThisFieldIsRequired'), 'required'); $form->addRule('forum_category', get_lang('ThisFieldIsRequired'), 'required'); $defaultSettingAllowNewThreads = api_get_default_tool_setting('forum', 'allow_new_threads', 0); // Settings the defaults if (empty($inputvalues) || !is_array($inputvalues)) { $defaults['allow_anonymous_group']['allow_anonymous'] = 0; $defaults['students_can_edit_group']['students_can_edit'] = 0; $defaults['approval_direct_group']['approval_direct'] = 0; $defaults['allow_attachments_group']['allow_attachments'] = 1; $defaults['allow_new_threads_group']['allow_new_threads'] = $defaultSettingAllowNewThreads; $defaults['default_view_type_group']['default_view_type'] = api_get_setting('default_forum_view'); $defaults['public_private_group_forum_group']['public_private_group_forum'] = 'public'; if (isset($_GET['forumcategory'])) { $defaults['forum_category'] = Security::remove_XSS($_GET['forumcategory']); } } else { // the default values when editing = the data in the table $defaults['forum_id'] = isset($inputvalues['forum_id']) ? $inputvalues['forum_id'] : null; $defaults['forum_title'] = prepare4display(isset($inputvalues['forum_title']) ? $inputvalues['forum_title'] : null); $defaults['forum_comment'] = prepare4display(isset($inputvalues['forum_comment']) ? $inputvalues['forum_comment'] : null); $defaults['forum_category'] = isset($inputvalues['forum_category']) ? $inputvalues['forum_category'] : null; $defaults['allow_anonymous_group']['allow_anonymous'] = isset($inputvalues['allow_anonymous']) ? $inputvalues['allow_anonymous'] : null; $defaults['students_can_edit_group']['students_can_edit'] = isset($inputvalues['allow_edit']) ? $inputvalues['allow_edit'] : null; $defaults['approval_direct_group']['approval_direct'] = isset($inputvalues['approval_direct_post']) ? $inputvalues['approval_direct_post'] : null; $defaults['allow_attachments_group']['allow_attachments'] = isset($inputvalues['allow_attachments']) ? $inputvalues['allow_attachments'] : null; $defaults['allow_new_threads_group']['allow_new_threads'] = isset($inputvalues['allow_new_threads']) ? $inputvalues['allow_new_threads'] : $defaultSettingAllowNewThreads; $defaults['default_view_type_group']['default_view_type'] = isset($inputvalues['default_view']) ? $inputvalues['default_view'] : null; $defaults['public_private_group_forum_group']['public_private_group_forum'] = isset($inputvalues['forum_group_public_private']) ? $inputvalues['forum_group_public_private'] : null; $defaults['group_forum'] = isset($inputvalues['forum_of_group']) ? $inputvalues['forum_of_group'] : null; } $form->setDefaults($defaults); // Validation or display if ($form->validate()) { $check = Security::check_token('post'); if ($check) { $values = $form->exportValues(); $return_message = store_forum($values); Display :: display_confirmation_message($return_message); } Security::clear_token(); } else { $token = Security::get_token(); $form->addElement('hidden', 'sec_token'); $form->setConstants(array('sec_token' => $token)); $form->display(); } } /** * This function deletes the forum image if exists * * @param int forum id * @return boolean true if success * @author Julio Montoya * @version february 2006, dokeos 1.8 */ function delete_forum_image($forum_id) { $table_forums = Database::get_course_table(TABLE_FORUM); $course_id = api_get_course_int_id(); $forum_id = intval($forum_id); $sql = "SELECT forum_image FROM $table_forums WHERE forum_id = '".$forum_id."' AND c_id = $course_id"; $result = Database::query($sql); $row = Database::fetch_array($result); if ($row['forum_image'] != '') { $del_file = api_get_path(SYS_COURSE_PATH).api_get_course_path().'/upload/forum/images/'.$row['forum_image']; return @unlink($del_file); } else { return false; } } /** * This function displays the form that is used to edit a forum category. * This is more or less a copy from the show_add_forumcategory_form function with the only difference that is uses * some default values. I tried to have both in one function but this gave problems with the handle_forum_and_forumcategories function * (storing was done twice) * * @param array * @return void HTML * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function show_edit_forumcategory_form($inputvalues = array()) { $categoryId = $inputvalues['cat_id']; $form = new FormValidator('forumcategory', 'post', 'index.php?'.api_get_cidreq().'&id='.$categoryId); // Setting the form elements. $form->addElement('header', '', get_lang('EditForumCategory')); $form->addElement('hidden', 'forum_category_id'); $form->addElement('text', 'forum_category_title', get_lang('Title')); $form->addElement( 'html_editor', 'forum_category_comment', get_lang('Comment'), null, array('ToolbarSet' => 'Forum', 'Width' => '98%', 'Height' => '200') ); $form->addButtonUpdate(get_lang('ModifyCategory'), 'SubmitEditForumCategory'); // Setting the default values. $defaultvalues['forum_category_id'] = $inputvalues['cat_id']; $defaultvalues['forum_category_title'] = $inputvalues['cat_title']; $defaultvalues['forum_category_comment'] = $inputvalues['cat_comment']; $form->setDefaults($defaultvalues); // Setting the rules. $form->addRule('forum_category_title', get_lang('ThisFieldIsRequired'), 'required'); // Validation or display if ($form->validate()) { $check = Security::check_token('post'); if ($check) { $values = $form->exportValues(); store_forumcategory($values); } Security::clear_token(); } else { $token = Security::get_token(); $form->addElement('hidden', 'sec_token'); $form->setConstants(array('sec_token' => $token)); $form->display(); } } /** * This function stores the forum category in the database. * The new category is added to the end. * * @param array $values * @param array $courseInfo * @param bool $showMessage * @return void HMTL language variable * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function store_forumcategory($values, $courseInfo = array(), $showMessage = true) { $courseInfo = empty($courseInfo) ? api_get_course_info() : $courseInfo; $course_id = $courseInfo['real_id']; $table_categories = Database::get_course_table(TABLE_FORUM_CATEGORY); // Find the max cat_order. The new forum category is added at the end => max cat_order + & $sql = "SELECT MAX(cat_order) as sort_max FROM $table_categories WHERE c_id = $course_id"; $result = Database::query($sql); $row = Database::fetch_array($result); $new_max = $row['sort_max'] + 1; $session_id = api_get_session_id(); $clean_cat_title = $values['forum_category_title']; if (isset($values['forum_category_id'])) { // Storing after edition. $params = [ 'cat_title' => $clean_cat_title, 'cat_comment' => $values['forum_category_comment'], ]; Database::update( $table_categories, $params, [ 'c_id = ? AND cat_id = ?' => [ $course_id, $values['forum_category_id'], ], ] ); api_item_property_update( $courseInfo, TOOL_FORUM_CATEGORY, $values['forum_category_id'], 'ForumCategoryUpdated', api_get_user_id() ); $return_message = get_lang('ForumCategoryEdited'); } else { $params = [ 'c_id' => $course_id, 'cat_title' => $clean_cat_title, 'cat_comment' => $values['forum_category_comment'], 'cat_order' => $new_max, 'session_id' => $session_id ]; $last_id = Database::insert($table_categories, $params); if ($last_id > 0) { $sql = "UPDATE $table_categories SET cat_id = $last_id WHERE iid = $last_id"; Database::query($sql); api_item_property_update( $courseInfo, TOOL_FORUM_CATEGORY, $last_id, 'ForumCategoryAdded', api_get_user_id() ); api_set_default_visibility( $last_id, TOOL_FORUM_CATEGORY, 0, $courseInfo ); } $return_message = get_lang('ForumCategoryAdded'); } if ($showMessage) { Display:: display_confirmation_message($return_message); } return $last_id; } /** * This function stores the forum in the database. The new forum is added to the end. * * @param array $values * @param array $courseInfo * @param bool $returnId * @return string language variable * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function store_forum($values, $courseInfo = array(), $returnId = false) { $courseInfo = empty($courseInfo) ? api_get_course_info() : $courseInfo; $course_id = $courseInfo['real_id']; $session_id = api_get_session_id(); if (isset($values['group_id']) && !empty($values['group_id'])) { $group_id = $values['group_id']; } else { $group_id = api_get_group_id(); } $table_forums = Database::get_course_table(TABLE_FORUM); // Find the max forum_order for the given category. The new forum is added at the end => max cat_order + & if (is_null($values['forum_category'])) { $new_max = null; } else { $sql = "SELECT MAX(forum_order) as sort_max FROM ".$table_forums." WHERE c_id = $course_id AND forum_category='".Database::escape_string($values['forum_category'])."'"; $result = Database::query($sql); $row = Database::fetch_array($result); $new_max = $row['sort_max'] + 1; } $clean_title = Database::escape_string($values['forum_title']); // Forum images $image_moved = false; if (!empty($_FILES['picture']['name'])) { $upload_ok = process_uploaded_file($_FILES['picture']); $has_attachment = true; } else { $image_moved = true; } // Remove existing picture if it was requested. if (!empty($_POST['remove_picture'])) { delete_forum_image($values['forum_id']); } if (isset($upload_ok)) { if ($has_attachment) { $course_dir = $courseInfo['path'].'/upload/forum/images'; $sys_course_path = api_get_path(SYS_COURSE_PATH); $updir = $sys_course_path.$course_dir; // Try to add an extension to the file if it hasn't one. $new_file_name = add_ext_on_mime(Database::escape_string($_FILES['picture']['name']), $_FILES['picture']['type']); if (!filter_extension($new_file_name)) { //Display :: display_error_message(get_lang('UplUnableToSaveFileFilteredExtension')); $image_moved = false; } else { $file_extension = explode('.', $_FILES['picture']['name']); $file_extension = strtolower($file_extension[sizeof($file_extension) - 1]); $new_file_name = uniqid('').'.'.$file_extension; $new_path = $updir.'/'.$new_file_name; $result = @move_uploaded_file($_FILES['picture']['tmp_name'], $new_path); // Storing the attachments if any if ($result) { $image_moved = true; } } } } if (isset($values['forum_id'])) { $sql_image = isset($sql_image) ? $sql_image : ''; $new_file_name = isset($new_file_name) ? $new_file_name : ''; if ($image_moved) { if (empty($_FILES['picture']['name'])) { $sql_image = ""; } else { $sql_image = $new_file_name; delete_forum_image($values['forum_id']); } } // Storing after edition. $params = [ 'forum_title'=> $values['forum_title'], 'forum_image'=> $sql_image, 'forum_comment'=> $values['forum_comment'], 'forum_category'=> $values['forum_category'], 'allow_anonymous'=> $values['allow_anonymous_group']['allow_anonymous'], 'allow_edit'=> $values['students_can_edit_group']['students_can_edit'], 'approval_direct_post'=> $values['approval_direct_group']['approval_direct'], 'allow_attachments'=> $values['allow_attachments_group']['allow_attachments'], 'allow_new_threads'=> $values['allow_new_threads_group']['allow_new_threads'], 'default_view'=> $values['default_view_type_group']['default_view_type'], 'forum_of_group'=> $values['group_forum'], 'forum_group_public_private'=> $values['public_private_group_forum_group']['public_private_group_forum'], 'forum_order'=> $new_max, 'session_id'=> $session_id, ]; Database::update( $table_forums, $params, ['c_id = ? AND forum_id = ?' => [$course_id, $values['forum_id']]] ); api_item_property_update( $courseInfo, TOOL_FORUM, Database::escape_string($values['forum_id']), 'ForumUpdated', api_get_user_id(), $group_id ); $return_message = get_lang('ForumEdited'); } else { if ($image_moved) { $new_file_name = isset($new_file_name) ? $new_file_name : ''; } $params = [ 'c_id' => $course_id, 'forum_title'=> $values['forum_title'], 'forum_image'=> $new_file_name, 'forum_comment'=> isset($values['forum_comment']) ? $values['forum_comment'] : null, 'forum_category'=> isset($values['forum_category']) ? $values['forum_category'] : null, 'allow_anonymous'=> isset($values['allow_anonymous_group']['allow_anonymous']) ? $values['allow_anonymous_group']['allow_anonymous'] : null, 'allow_edit'=> isset($values['students_can_edit_group']['students_can_edit']) ? $values['students_can_edit_group']['students_can_edit'] : null, 'approval_direct_post'=> isset($values['approval_direct_group']['approval_direct']) ? $values['approval_direct_group']['approval_direct'] : null, 'allow_attachments'=> isset($values['allow_attachments_group']['allow_attachments']) ? $values['allow_attachments_group']['allow_attachments'] : null, 'allow_new_threads'=> isset($values['allow_new_threads_group']['allow_new_threads']) ? $values['allow_new_threads_group']['allow_new_threads'] : null, 'default_view'=> isset($values['default_view_type_group']['default_view_type']) ? $values['default_view_type_group']['default_view_type'] : null, 'forum_of_group'=> isset($values['group_forum']) ? $values['group_forum'] : null, 'forum_group_public_private'=> isset($values['public_private_group_forum_group']['public_private_group_forum']) ? $values['public_private_group_forum_group']['public_private_group_forum'] : null, 'forum_order'=> isset($new_max) ? $new_max : null, 'session_id'=> $session_id, ]; $last_id = Database::insert($table_forums, $params); if ($last_id > 0) { $sql = "UPDATE $table_forums SET forum_id = iid WHERE iid = $last_id"; Database::query($sql); api_item_property_update( $courseInfo, TOOL_FORUM, $last_id, 'ForumAdded', api_get_user_id(), $group_id ); api_set_default_visibility( $last_id, TOOL_FORUM, $group_id, $courseInfo ); } $return_message = get_lang('ForumAdded'); if ($returnId) { return $last_id; } } return $return_message; } /** * This function deletes a forum or a forum category * This function currently does not delete the forums inside the category, * nor the threads and replies inside these forums. * For the moment this is the easiest method and it has the advantage that it * allows to recover fora that were acidently deleted * when the forum category got deleted. * * @param $content = what we are deleting (a forum or a forum category) * @param $id The id of the forum category that has to be deleted. * * @todo write the code for the cascading deletion of the forums inside a * forum category and also the threads and replies inside these forums * @todo config setting for recovery or not * (see also the documents tool: real delete or not). * @return string * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function deleteForumCategoryThread($content, $id) { $_course = api_get_course_info(); $table_forums = Database::get_course_table(TABLE_FORUM); $table_forums_post = Database::get_course_table(TABLE_FORUM_POST); $table_forum_thread = Database::get_course_table(TABLE_FORUM_THREAD); $course_id = api_get_course_int_id(); $groupId = api_get_group_id(); $userId = api_get_user_id(); $id = intval($id); // Delete all attachment file about this tread id. $sql = "SELECT post_id FROM $table_forums_post WHERE c_id = $course_id AND thread_id = '".$id."' "; $res = Database::query($sql); while ($poster_id = Database::fetch_row($res)) { delete_attachment($poster_id[0]); } $tool_constant = null; $return_message = ''; if ($content == 'forumcategory') { $tool_constant = TOOL_FORUM_CATEGORY; $return_message = get_lang('ForumCategoryDeleted'); if (!empty($forum_list)) { $sql = "SELECT forum_id FROM ".$table_forums." WHERE c_id = $course_id AND forum_category='".$id."'"; $result = Database::query($sql); $row = Database::fetch_array($result); foreach ($row as $arr_forum) { $forum_id = $arr_forum['forum_id']; api_item_property_update( $_course, 'forum', $forum_id, 'delete', api_get_user_id() ); } } } if ($content == 'forum') { $tool_constant = TOOL_FORUM; $return_message = get_lang('ForumDeleted'); if (!empty($number_threads)) { $sql = "SELECT thread_id FROM".$table_forum_thread." WHERE c_id = $course_id AND forum_id='".$id."'"; $result = Database::query($sql); $row = Database::fetch_array($result); foreach ($row as $arr_forum) { $forum_id = $arr_forum['thread_id']; api_item_property_update($_course, 'forum_thread', $forum_id, 'delete', api_get_user_id()); } } } if ($content == 'thread') { $tool_constant = TOOL_FORUM_THREAD; $return_message = get_lang('ThreadDeleted'); } api_item_property_update( $_course, $tool_constant, $id, 'delete', $userId, $groupId ); // Check if this returns a true and if so => return $return_message, if not => return false; return $return_message; } /** * This function deletes a forum post. This separate function is needed because forum posts do not appear in the item_property table (yet) * and because deleting a post also has consequence on the posts that have this post as parent_id (they are also deleted). * an alternative would be to store the posts also in item_property and mark this post as deleted (visibility = 2). * We also have to decrease the number of replies in the thread table * * @param $post_id the id of the post that will be deleted * @todo write recursive function that deletes all the posts that have this message as parent * @return string language variable * @author Patrick Cool , Ghent University * @author Hubert Borderiou Function cleanead and fixed * @version february 2006 */ function delete_post($post_id) { $table_posts = Database :: get_course_table(TABLE_FORUM_POST); $table_threads = Database :: get_course_table(TABLE_FORUM_THREAD); $post_id = intval($post_id); $course_id = api_get_course_int_id(); // Get parent_post_id of deleted post. $tab_post_info = get_post_information($post_id); if ($tab_post_info) { $post_parent_id_of_deleted_post = intval($tab_post_info['post_parent_id']); $thread_id_of_deleted_post = $tab_post_info['thread_id']; $forum_if_of_deleted_post = $tab_post_info['forum_id']; $sql = "UPDATE $table_posts SET post_parent_id=$post_parent_id_of_deleted_post WHERE c_id = $course_id AND post_parent_id=$post_id AND thread_id=$thread_id_of_deleted_post AND forum_id=$forum_if_of_deleted_post"; Database::query($sql); // Note: This has to be a recursive function that deletes all of the posts in this block. $sql = "DELETE FROM $table_posts WHERE c_id = $course_id AND post_id = ".intval($post_id).""; Database::query($sql); // Delete attachment file about this post id. delete_attachment($post_id); } $last_post_of_thread = check_if_last_post_of_thread($_GET['thread']); if (is_array($last_post_of_thread)) { // Decreasing the number of replies for this thread and also changing the last post information. $sql = "UPDATE $table_threads SET thread_replies=thread_replies-1, thread_last_post = ".intval($last_post_of_thread['post_id']).", thread_date='".Database::escape_string($last_post_of_thread['post_date'])."' WHERE c_id = $course_id AND thread_id = ".intval($_GET['thread']).""; Database::query($sql); return 'PostDeleted'; } if (!$last_post_of_thread) { // We deleted the very single post of the thread so we need to delete the entry in the thread table also. $sql = "DELETE FROM $table_threads WHERE c_id = $course_id AND thread_id = ".intval($_GET['thread']).""; Database::query($sql); return 'PostDeletedSpecial'; } } /** * This function gets the all information of the last (=most recent) post of the thread * This can be done by sorting the posts that have the field thread_id=$thread_id and sort them by post_date * * @param $thread_id the id of the thread we want to know the last post of. * @return an array or bool if there is a last post found, false if there is no post entry linked to that thread => thread will be deleted * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function check_if_last_post_of_thread($thread_id) { $table_posts = Database :: get_course_table(TABLE_FORUM_POST); $course_id = api_get_course_int_id(); $sql = "SELECT * FROM $table_posts WHERE c_id = $course_id AND thread_id = ".intval($thread_id)." ORDER BY post_date DESC"; $result = Database::query($sql); if (Database::num_rows($result) > 0) { $row = Database::fetch_array($result); return $row; } else { return false; } } /** * This function takes care of the display of the visibility icon * * @param $content what is it that we want to make (in)visible: forum category, forum, thread, post * @param $id the id of the content we want to make invisible * @param $current_visibility_status what is the current status of the visibility (0 = invisible, 1 = visible) * @return void string HTML * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function display_visible_invisible_icon($content, $id, $current_visibility_status, $additional_url_parameters = '') { echo return_visible_invisible_icon($content, $id, $current_visibility_status, $additional_url_parameters); } /** * @param $content what is it that we want to make (in)visible: forum category, forum, thread, post * @param $id the id of the content we want to make invisible * @param $current_visibility_status what is the current status of the visibility (0 = invisible, 1 = visible) * @return string HTML */ function return_visible_invisible_icon($content, $id, $current_visibility_status, $additional_url_parameters = '') { $html = ''; $id = Security::remove_XSS($id); if ($current_visibility_status == '1') { $html .= ''.Display::return_icon('visible.png', get_lang('MakeInvisible'), array(), ICON_SIZE_SMALL).''; } if ($current_visibility_status == '0') { $html .= '' . Display::return_icon('invisible.png', get_lang('MakeVisible'), array(), ICON_SIZE_SMALL) . ''; } return $html; } /** * This function takes care of the display of the lock icon * * @param $content what is it that we want to (un)lock: forum category, forum, thread, post * @param $id the id of the content we want to (un)lock * @param $current_visibility_status what is the current status of the visibility (0 = invisible, 1 = visible) * @return void display the lock HTML. * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function display_lock_unlock_icon($content, $id, $current_lock_status, $additional_url_parameters = '') { echo return_lock_unlock_icon($content, $id, $current_lock_status, $additional_url_parameters); } function return_lock_unlock_icon($content, $id, $current_lock_status, $additional_url_parameters = '') { $html = ''; $id = intval($id); //check if the forum is blocked due if ($content == 'thread') { if (api_resource_is_locked_by_gradebook($id, LINK_FORUM_THREAD)) { $html .= Display::return_icon('lock_na.png', get_lang('ResourceLockedByGradebook'), array(), ICON_SIZE_SMALL); return $html; } } if ($current_lock_status == '1') { $html .= ''.Display::return_icon('lock.png', get_lang('Unlock'), array(), ICON_SIZE_SMALL).''; } if ($current_lock_status == '0') { $html .= '' . Display::return_icon('unlock.png', get_lang('Lock'), array(), ICON_SIZE_SMALL) . ''; } return $html; } /** * This function takes care of the display of the up and down icon * * @param $content what is it that we want to make (in)visible: forum category, forum, thread, post * @param $id is the id of the item we want to display the icons for * @param $list is an array of all the items. All items in this list should have an up and down icon except for the first (no up icon) and the last (no down icon) * The key of this $list array is the id of the item. * * @return void HTML * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function display_up_down_icon($content, $id, $list) { echo return_up_down_icon($content, $id, $list); } function return_up_down_icon($content, $id, $list) { $id = strval(intval($id)); $total_items = count($list); $position = 0; $internal_counter = 0; $forumCategory = isset($_GET['forumcategory']) ? Security::remove_XSS($_GET['forumcategory']) : null; if (is_array($list)) { foreach ($list as $key => $listitem) { $internal_counter++; if ($id == $key) { $position = $internal_counter; } } } if ($position > 1) { $return_value = ''. Display::return_icon('up.png', get_lang('MoveUp'), array(), ICON_SIZE_SMALL).''; } else { $return_value = Display::return_icon('up_na.png', '-', array(), ICON_SIZE_SMALL); } if ($position < $total_items) { $return_value .= ''. Display::return_icon('down.png', get_lang('MoveDown'), array(), ICON_SIZE_SMALL).''; } else { $return_value .= Display::return_icon('down_na.png', '-', array(), ICON_SIZE_SMALL); } return $return_value; } /** * This function changes the visibility in the database (item_property) * * @param string $content what is it that we want to make (in)visible: forum category, forum, thread, post * @param int $id the id of the content we want to make invisible * @param string $target_visibility what is the current status of the visibility (0 = invisible, 1 = visible) * * @todo change the get parameter so that it matches the tool constants. * @todo check if api_item_property_update returns true or false => returnmessage depends on it. * @todo move to itemmanager * * @return string language variable * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function change_visibility($content, $id, $target_visibility) { $_course = api_get_course_info(); $constants = array( 'forumcategory' => TOOL_FORUM_CATEGORY, 'forum' => TOOL_FORUM, 'thread' => TOOL_FORUM_THREAD ); api_item_property_update( $_course, $constants[$content], $id, $target_visibility, api_get_user_id() ); if ($target_visibility == 'visible') { handle_mail_cue($content, $id); } return get_lang('VisibilityChanged'); } /** * This function changes the lock status in the database * * @param $content what is it that we want to (un)lock: forum category, forum, thread, post * @param $id the id of the content we want to (un)lock * @param $action do we lock (=>locked value in db = 1) or unlock (=> locked value in db = 0) * @return string, language variable * * @todo move to item manager * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function change_lock_status($content, $id, $action) { $table_categories = Database :: get_course_table(TABLE_FORUM_CATEGORY); $table_forums = Database :: get_course_table(TABLE_FORUM); $table_threads = Database :: get_course_table(TABLE_FORUM_THREAD); // Determine the relevant table. if ($content == 'forumcategory') { $table = $table_categories; $id_field = 'cat_id'; } elseif ($content == 'forum') { $table = $table_forums; $id_field = 'forum_id'; } elseif ($content == 'thread') { $table = $table_threads; $id_field = 'thread_id'; } else { return get_lang('Error'); } // Determine what we are doing => defines the value for the database and the return message. if ($action == 'lock') { $db_locked = 1; $return_message = get_lang('Locked'); } elseif ($action == 'unlock') { $db_locked = 0; $return_message = get_lang('Unlocked'); } else { return get_lang('Error'); } $course_id = api_get_course_int_id(); // Doing the change in the database $sql = "UPDATE $table SET locked='".Database::escape_string($db_locked)."' WHERE c_id = $course_id AND $id_field='".Database::escape_string($id)."'"; if (Database::query($sql)) { return $return_message; } else { return get_lang('Error'); } } /** * This function moves a forum or a forum category up or down * * @param $content what is it that we want to make (in)visible: forum category, forum, thread, post * @param $direction do we want to move it up or down. * @param $id the id of the content we want to make invisible * @todo consider removing the table_item_property calls here but this can * prevent unwanted side effects when a forum does not have an entry in * the item_property table but does have one in the forum table. * @return string language variable * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function move_up_down($content, $direction, $id) { $table_categories = Database :: get_course_table(TABLE_FORUM_CATEGORY); $table_forums = Database :: get_course_table(TABLE_FORUM); $table_item_property = Database :: get_course_table(TABLE_ITEM_PROPERTY); $course_id = api_get_course_int_id(); $id = intval($id); // Determine which field holds the sort order. if ($content == 'forumcategory') { $table = $table_categories; $sort_column = 'cat_order'; $id_column = 'cat_id'; $sort_column = 'cat_order'; } elseif ($content == 'forum') { $table = $table_forums; $sort_column = 'forum_order'; $id_column = 'forum_id'; $sort_column = 'forum_order'; // We also need the forum_category of this forum. $sql = "SELECT forum_category FROM $table_forums WHERE c_id = $course_id AND forum_id = ".intval($id); $result = Database::query($sql); $row = Database::fetch_array($result); $forum_category = $row['forum_category']; } else { return get_lang('Error'); } // Determine the need for sorting ascending or descending order. if ($direction == 'down') { $sort_direction = 'ASC'; } elseif ($direction == 'up') { $sort_direction = 'DESC'; } else { return get_lang('Error'); } // The SQL statement if ($content == 'forumcategory') { $sql = "SELECT * FROM $table_categories forum_categories, $table_item_property item_properties WHERE forum_categories.c_id = $course_id AND item_properties.c_id = $course_id AND forum_categories.cat_id=item_properties.ref AND item_properties.tool='" . TOOL_FORUM_CATEGORY . "' ORDER BY forum_categories.cat_order $sort_direction"; } if ($content == 'forum') { $sql = "SELECT * FROM $table WHERE c_id = $course_id AND forum_category='" . Database::escape_string($forum_category) . "' ORDER BY forum_order $sort_direction"; } // echo $sql.'
'; // Finding the items that need to be switched. $result = Database::query($sql); $found = false; while ($row = Database::fetch_array($result)) { //echo $row[$id_column].'-'; if ($found) { $next_id = $row[$id_column]; $next_sort = $row[$sort_column]; $found = false; } if ($id == $row[$id_column]) { $this_id = $id; $this_sort = $row[$sort_column]; $found = true; } } // Committing the switch. // We do an extra check if we do not have illegal values. If your remove this if statment you will // be able to mess with the sorting by refreshing the page over and over again. if ($this_sort != '' && $next_sort != '' && $next_id != '' && $this_id != '') { $sql_update1 = "UPDATE $table SET $sort_column='".Database::escape_string($this_sort)."' WHERE c_id = $course_id AND $id_column='".Database::escape_string($next_id)."'"; $sql_update2 = "UPDATE $table SET $sort_column='".Database::escape_string($next_sort)."' WHERE c_id = $course_id AND $id_column='".Database::escape_string($this_id)."'"; Database::query($sql_update1); Database::query($sql_update2); } return get_lang(ucfirst($content).'Moved'); } /** * This function returns a piece of html code that make the links grey (=invisible for the student) * * @param int 0 = invisible, 1 = visible * @return string language variable * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function class_visible_invisible($current_visibility_status) { $current_visibility_status = intval($current_visibility_status); if ($current_visibility_status == 0) { return 'class="invisible"'; } } function return_visible_invisible($current_visibility_status) { $current_visibility_status = intval($current_visibility_status); if ($current_visibility_status == 0) { $status='invisible'; return $status; } } /** * Retrieve all the information off the forum categories (or one specific) for the current course. * The categories are sorted according to their sorting order (cat_order * * @param int $id default ''. When an id is passed we only find the information * about that specific forum category. If no id is passed we get all the forum categories. * @return array containing all the information about all the forum categories * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function get_forum_categories($id = '') { $table_categories = Database :: get_course_table(TABLE_FORUM_CATEGORY); $table_item_property = Database :: get_course_table(TABLE_ITEM_PROPERTY); // Condition for the session $session_id = api_get_session_id(); $course_id = api_get_course_int_id(); $condition_session = api_get_session_condition($session_id, true, true, 'forum_categories.session_id'); $condition_session .= " AND forum_categories.c_id = $course_id AND item_properties.c_id = $course_id"; if (empty($id)) { $sql = "SELECT * FROM ".$table_categories." forum_categories, ".$table_item_property." item_properties WHERE forum_categories.cat_id=item_properties.ref AND item_properties.visibility=1 AND item_properties.tool = '".TOOL_FORUM_CATEGORY."' $condition_session ORDER BY forum_categories.cat_order ASC"; if (api_is_allowed_to_edit()) { $sql = "SELECT * FROM ".$table_categories." forum_categories, ".$table_item_property." item_properties WHERE forum_categories.cat_id=item_properties.ref AND item_properties.visibility<>2 AND item_properties.tool='".TOOL_FORUM_CATEGORY."' $condition_session ORDER BY forum_categories.cat_order ASC"; } } else { $sql = "SELECT * FROM ".$table_categories." forum_categories, ".$table_item_property." item_properties WHERE forum_categories.cat_id=item_properties.ref AND item_properties.tool='".TOOL_FORUM_CATEGORY."' AND forum_categories.cat_id = ".intval($id)." $condition_session ORDER BY forum_categories.cat_order ASC"; } $result = Database::query($sql); $forum_categories_list = array(); while ($row = Database::fetch_array($result)) { if (empty($id)) { $forum_categories_list[$row['cat_id']] = $row; } else { $forum_categories_list = $row; } } return $forum_categories_list; } /** * This function retrieves all the fora in a given forum category * * @param int $cat_id the id of the forum category * @return array containing all the information about the forums (regardless of their category) * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function get_forums_in_category($cat_id) { $table_forums = Database::get_course_table(TABLE_FORUM); $table_item_property = Database::get_course_table(TABLE_ITEM_PROPERTY); $forum_list = array(); $course_id = api_get_course_int_id(); $sql = "SELECT * FROM ".$table_forums." forum , ".$table_item_property." item_properties WHERE forum.forum_category='".Database::escape_string($cat_id)."' AND forum.forum_id=item_properties.ref AND item_properties.visibility = 1 AND item_properties.c_id = $course_id AND item_properties.tool='".TOOL_FORUM."' AND forum.c_id = $course_id ORDER BY forum.forum_order ASC"; if (api_is_allowed_to_edit()) { $sql = "SELECT * FROM ".$table_forums." forum , ".$table_item_property." item_properties WHERE forum.forum_category = '".Database::escape_string($cat_id)."' AND forum.forum_id = item_properties.ref AND item_properties.visibility <> 2 AND item_properties.tool = '".TOOL_FORUM."' AND item_properties.c_id = $course_id AND forum.c_id = $course_id ORDER BY forum_order ASC"; } $result = Database::query($sql); while ($row = Database::fetch_array($result)) { $forum_list[$row['forum_id']] = $row; } return $forum_list; } /** * Retrieve all the forums (regardless of their category) or of only one. * The forums are sorted according to the forum_order. * Since it does not take the forum category into account there probably * will be two or more forums that have forum_order=1, ... * @param int $id forum id * @param string $course_code * @param bool $includeGroupsForum * @param int $sessionId * @return array an array containing all the information about the forums (regardless of their category) * @todo check $sql4 because this one really looks fishy. * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function get_forums( $id = '', $course_code = '', $includeGroupsForum = true, $sessionId = 0 ) { $course_info = api_get_course_info($course_code); $table_users = Database :: get_main_table(TABLE_MAIN_USER); $table_forums = Database :: get_course_table(TABLE_FORUM); $table_threads = Database :: get_course_table(TABLE_FORUM_THREAD); $table_posts = Database :: get_course_table(TABLE_FORUM_POST); $table_item_property = Database :: get_course_table(TABLE_ITEM_PROPERTY); // GETTING ALL THE FORUMS // Condition for the session if (empty($sessionId)) { $session_id = api_get_session_id(); } else { $session_id = $sessionId; } $condition_session = api_get_session_condition( $session_id, true, false, 'item_properties.session_id' ); $course_id = $course_info['real_id']; $forum_list = array(); $includeGroupsForumSelect = ""; if (!$includeGroupsForum) { $includeGroupsForumSelect = " AND forum_of_group = 0 "; } if ($id == '') { // Student // Select all the forum information of all forums (that are visible to students). $sql = "SELECT * FROM $table_forums forum INNER JOIN ".$table_item_property." item_properties ON ( forum.forum_id = item_properties.ref AND forum.c_id = item_properties.c_id ) WHERE item_properties.visibility=1 AND item_properties.tool = '".TOOL_FORUM."' $condition_session AND forum.c_id = $course_id AND item_properties.c_id = $course_id $includeGroupsForumSelect ORDER BY forum.forum_order ASC"; // Select the number of threads of the forums (only the threads that are visible). $sql2 = "SELECT count(*) AS number_of_threads, threads.forum_id FROM $table_threads threads INNER JOIN ".$table_item_property." item_properties ON ( threads.thread_id=item_properties.ref AND threads.c_id = item_properties.c_id AND threads.session_id = item_properties.session_id ) WHERE item_properties.visibility=1 AND item_properties.tool='".TOOL_FORUM_THREAD."' AND threads.c_id = $course_id AND item_properties.c_id = $course_id GROUP BY threads.forum_id"; // Select the number of posts of the forum (post that are visible and that are in a thread that is visible). $sql3 = "SELECT count(*) AS number_of_posts, posts.forum_id FROM $table_posts posts, $table_threads threads, ".$table_item_property." item_properties WHERE posts.visible=1 AND posts.thread_id=threads.thread_id AND threads.thread_id=item_properties.ref AND threads.session_id = item_properties.session_id AND item_properties.visibility=1 AND item_properties.tool='".TOOL_FORUM_THREAD."' AND threads.c_id = $course_id AND posts.c_id = $course_id AND item_properties.c_id = $course_id GROUP BY threads.forum_id"; // Course Admin if (api_is_allowed_to_edit()) { // Select all the forum information of all forums (that are not deleted). $sql = "SELECT * FROM ".$table_forums." forum INNER JOIN ".$table_item_property." item_properties ON ( forum.forum_id = item_properties.ref AND forum.c_id = item_properties.c_id ) WHERE item_properties.visibility <> 2 AND item_properties.tool='".TOOL_FORUM."' $condition_session AND forum.c_id = $course_id AND item_properties.c_id = $course_id $includeGroupsForumSelect ORDER BY forum_order ASC"; // Select the number of threads of the forums (only the threads that are not deleted). $sql2 = "SELECT count(*) AS number_of_threads, threads.forum_id FROM $table_threads threads INNER JOIN ".$table_item_property." item_properties ON ( threads.thread_id=item_properties.ref AND threads.c_id = item_properties.c_id AND threads.session_id = item_properties.session_id ) WHERE item_properties.visibility<>2 AND item_properties.tool='".TOOL_FORUM_THREAD."' AND threads.c_id = $course_id AND item_properties.c_id = $course_id GROUP BY threads.forum_id"; // Select the number of posts of the forum. $sql3 = "SELECT count(*) AS number_of_posts, posts.forum_id FROM $table_posts posts, $table_threads threads, ".$table_item_property." item_properties WHERE posts.thread_id=threads.thread_id AND threads.thread_id=item_properties.ref AND threads.session_id = item_properties.session_id AND item_properties.visibility=1 AND item_properties.tool='".TOOL_FORUM_THREAD."' AND posts.c_id = $course_id AND threads.c_id = $course_id AND item_properties.c_id = $course_id GROUP BY threads.forum_id"; } } else { // GETTING ONE SPECIFIC FORUM /* We could do the splitup into student and course admin also but we want to have as much as information about a certain forum as possible so we do not take too much information into account. This function (or this section of the function) is namely used to fill the forms when editing a forum (and for the moment it is the only place where we use this part of the function) */ // Select all the forum information of the given forum (that is not deleted). $sql = "SELECT * FROM $table_forums forum, ".$table_item_property." item_properties WHERE forum.forum_id=item_properties.ref AND forum_id = ".intval($id)." AND item_properties.visibility<>2 AND item_properties.tool='".TOOL_FORUM."' $condition_session AND forum.c_id = $course_id AND item_properties.c_id = $course_id ORDER BY forum_order ASC"; // Select the number of threads of the forum. $sql2 = "SELECT count(*) AS number_of_threads, forum_id FROM $table_threads WHERE forum_id = ".intval($id)." AND c_id = $course_id GROUP BY forum_id"; // Select the number of posts of the forum. $sql3 = "SELECT count(*) AS number_of_posts, forum_id FROM $table_posts WHERE forum_id = ".intval($id)." AND c_id = $course_id GROUP BY forum_id"; // Select the last post and the poster (note: this is probably no longer needed). $sql4 = "SELECT post.post_id, post.forum_id, post.poster_id, post.poster_name, post.post_date, users.lastname, users.firstname FROM $table_posts post, $table_users users WHERE forum_id = ".intval($id)." AND post.poster_id=users.user_id AND post.c_id = $course_id GROUP BY post.forum_id ORDER BY post.post_id ASC"; } // Handling all the forum information. $result = Database::query($sql); while ($row = Database::fetch_array($result)) { if ($id == '') { $forum_list[$row['forum_id']] = $row; } else { $forum_list = $row; } } // Handling the thread count information. $result2 = Database::query($sql2); while ($row2 = Database::fetch_array($result2)) { if ($id == '') { $forum_list[$row2['forum_id']]['number_of_threads'] = $row2['number_of_threads']; } else { $forum_list['number_of_threads'] = $row2['number_of_threads']; } } // Handling the postcount information. $result3 = Database::query($sql3); while ($row3 = Database::fetch_array($result3)) { if ($id == '') { // This is needed because sql3 takes also the deleted forums into account. if (array_key_exists($row3['forum_id'], $forum_list)) { $forum_list[$row3['forum_id']]['number_of_posts'] = $row3['number_of_posts']; } } else { $forum_list['number_of_posts'] = $row3['number_of_posts']; } } /* Finding the last post information (last_post_id, last_poster_id, last_post_date, last_poster_name, last_poster_lastname, last_poster_firstname)*/ if ($id == '') { if (is_array($forum_list)) { foreach ($forum_list as $key => $value) { $last_post_info_of_forum = get_last_post_information($key, api_is_allowed_to_edit(), $course_id); $forum_list[$key]['last_post_id'] = $last_post_info_of_forum['last_post_id']; $forum_list[$key]['last_poster_id'] = $last_post_info_of_forum['last_poster_id']; $forum_list[$key]['last_post_date'] = $last_post_info_of_forum['last_post_date']; $forum_list[$key]['last_poster_name'] = $last_post_info_of_forum['last_poster_name']; $forum_list[$key]['last_poster_lastname'] = $last_post_info_of_forum['last_poster_lastname']; $forum_list[$key]['last_poster_firstname'] = $last_post_info_of_forum['last_poster_firstname']; } } else { $forum_list = array(); } } else { $last_post_info_of_forum = get_last_post_information($id, api_is_allowed_to_edit(), $course_id); $forum_list['last_post_id'] = $last_post_info_of_forum['last_post_id']; $forum_list['last_poster_id'] = $last_post_info_of_forum['last_poster_id']; $forum_list['last_post_date'] = $last_post_info_of_forum['last_post_date']; $forum_list['last_poster_name'] = $last_post_info_of_forum['last_poster_name']; $forum_list['last_poster_lastname'] = $last_post_info_of_forum['last_poster_lastname']; $forum_list['last_poster_firstname'] = $last_post_info_of_forum['last_poster_firstname']; } return $forum_list; } /** * @param int $course_id * @param int $thread_id * @param int $forum_id * @param bool $show_visible * @return array|bool */ function get_last_post_by_thread($course_id, $thread_id, $forum_id, $show_visible = true) { if (empty($thread_id) || empty($forum_id) || empty($course_id)) { return false; } $thread_id = intval($thread_id); $forum_id = intval($forum_id); $course_id = intval($course_id); $table_posts = Database :: get_course_table(TABLE_FORUM_POST); $sql = "SELECT * FROM $table_posts WHERE c_id = $course_id AND thread_id = $thread_id AND forum_id = $forum_id"; if ($show_visible == false) { $sql .= " AND visible = 1 "; } $sql .= " ORDER BY post_id DESC LIMIT 1"; $result = Database::query($sql); if (Database::num_rows($result)) { return Database::fetch_array($result, 'ASSOC'); } else { return false; } } /** * This function gets all the last post information of a certain forum * * @param int $forum_id the id of the forum we want to know the last post information of. * @param bool $show_invisibles * @param string course db name * @return array containing all the information about the last post * (last_post_id, last_poster_id, last_post_date, last_poster_name, last_poster_lastname, last_poster_firstname) * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function get_last_post_information($forum_id, $show_invisibles = false, $course_id = null) { if (!isset($course_id)) { $course_id = api_get_course_int_id(); } else { $course_id = intval($course_id); } $table_posts = Database :: get_course_table(TABLE_FORUM_POST); $table_item_property = Database :: get_course_table(TABLE_ITEM_PROPERTY); $table_users = Database :: get_main_table(TABLE_MAIN_USER); $sql = "SELECT post.post_id, post.forum_id, post.poster_id, post.poster_name, post.post_date, users.lastname, users.firstname, post.visible, thread_properties.visibility AS thread_visibility, forum_properties.visibility AS forum_visibility FROM $table_posts post, $table_users users, $table_item_property thread_properties, $table_item_property forum_properties WHERE post.forum_id = ".intval($forum_id)." AND post.poster_id=users.user_id AND post.thread_id=thread_properties.ref AND thread_properties.tool='".TOOL_FORUM_THREAD."' AND post.forum_id=forum_properties.ref AND forum_properties.tool='".TOOL_FORUM."' AND post.c_id = $course_id AND thread_properties.c_id = $course_id AND forum_properties.c_id = $course_id ORDER BY post.post_id DESC"; $result = Database::query($sql); if ($show_invisibles) { $row = Database::fetch_array($result); $return_array['last_post_id'] = $row['post_id']; $return_array['last_poster_id'] = $row['poster_id']; $return_array['last_post_date'] = $row['post_date']; $return_array['last_poster_name'] = $row['poster_name']; $return_array['last_poster_lastname'] = $row['lastname']; $return_array['last_poster_firstname'] = $row['firstname']; return $return_array; } else { // We have to loop through the results to find the first one that is // actually visible to students (forum_category, forum, thread AND post are visible). while ($row = Database::fetch_array($result)) { if ($row['visible'] == '1' && $row['thread_visibility'] == '1' && $row['forum_visibility'] == '1') { $return_array['last_post_id'] = $row['post_id']; $return_array['last_poster_id'] = $row['poster_id']; $return_array['last_post_date'] = $row['post_date']; $return_array['last_poster_name'] = $row['poster_name']; $return_array['last_poster_lastname'] = $row['lastname']; $return_array['last_poster_firstname'] = $row['firstname']; return $return_array; } } } } /** * Retrieve all the threads of a given forum * * @param int forum id * @param string course db name * @return an array containing all the information about the threads * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function get_threads($forum_id, $course_code = null) { $course_info = api_get_course_info($course_code); if (empty($course_info)) { return array(); } $course_id = $course_info['real_id']; $groupId = api_get_group_id(); $table_item_property = Database :: get_course_table(TABLE_ITEM_PROPERTY); $table_threads = Database :: get_course_table(TABLE_FORUM_THREAD); $table_users = Database :: get_main_table(TABLE_MAIN_USER); // important note: it might seem a little bit awkward that we have 'thread.locked as locked' in the sql statement // because we also have thread.* in it. This is because thread has a field locked and post also has the same field // since we are merging these we would have the post.locked value but in fact we want the thread.locked value // This is why it is added to the end of the field selection $groupCondition = api_get_group_id() != 0 ? " AND item_properties.to_group_id = '$groupId' AND item_properties.c_id = '$course_id'" : ""; $sql = "SELECT thread.*, item_properties.*, users.firstname, users.lastname, users.user_id, thread.locked as locked FROM $table_threads thread INNER JOIN $table_item_property item_properties ON thread.thread_id = item_properties.ref AND item_properties.c_id = thread.c_id AND item_properties.c_id = $course_id AND item_properties.tool = '".TABLE_FORUM_THREAD."' $groupCondition LEFT JOIN $table_users users ON thread.thread_poster_id=users.user_id WHERE item_properties.visibility='1' AND thread.forum_id = ".intval($forum_id)." ORDER BY thread.thread_sticky DESC, thread.thread_date DESC"; if (api_is_allowed_to_edit()) { $sql = "SELECT thread.*, item_properties.*, users.firstname, users.lastname, users.user_id, thread.locked as locked FROM $table_threads thread INNER JOIN $table_item_property item_properties ON thread.thread_id = item_properties.ref AND item_properties.c_id = $course_id AND thread.c_id = $course_id AND item_properties.tool = '".TABLE_FORUM_THREAD."' $groupCondition LEFT JOIN $table_users users ON thread.thread_poster_id=users.user_id WHERE item_properties.visibility<>2 AND thread.forum_id = ".intval($forum_id)." ORDER BY thread.thread_sticky DESC, thread.thread_date DESC"; } $result = Database::query($sql); $thread_list = array(); while ($row = Database::fetch_array($result, 'ASSOC')) { $thread_list[] = $row; } return $thread_list; } /** * Retrieve all posts of a given thread * @param int $threadId The thread ID * @param string $orderDirection Optional. The direction for sort the posts * @param boolean $recursive Optional. If the list is recursive * @param int $postId Optional. The post ID for recursive list * @param int $depth Optional. The depth to indicate the indent * @todo move to a repository * * @return array containing all the information about the posts of a given thread */ function getPosts($threadId, $orderDirection = 'ASC', $recursive = false, $postId = 0, $depth = -1) { $list = []; $em = Database::getManager(); if (api_is_allowed_to_edit(false, true)) { $visibleCriteria = Criteria::expr()->neq('visible', 2); } else { $visibleCriteria = Criteria::expr()->eq('visible', 1); } $criteria = Criteria::create(); $criteria ->where(Criteria::expr()->eq('threadId', $threadId)) ->andWhere(Criteria::expr()->eq('cId', api_get_course_int_id())) ->andWhere($visibleCriteria) ; if ($recursive) { $criteria->andWhere(Criteria::expr()->eq('postParentId', $postId)); } $qb = $em->getRepository('ChamiloCourseBundle:CForumPost')->createQueryBuilder('p'); $qb->select('p') ->addCriteria($criteria) ->addOrderBy('p.postId', $orderDirection); $posts = $qb->getQuery()->getResult(); $depth++; foreach ($posts as $post) { $user = $em->find('ChamiloUserBundle:User', $post->getPosterId()); $list[$post->getPostId()] = [ 'c_id' => $post->getCId(), 'post_id' => $post->getPostId(), 'post_title' => $post->getPostTitle(), 'post_text' => $post->getPostText(), 'thread_id' => $post->getThreadId(), 'forum_id' => $post->getForumId(), 'poster_id' => $post->getPosterId(), 'poster_name' => $post->getPosterName(), 'post_date' => $post->getPostDate(), 'post_notification' => $post->getPostNotification(), 'post_parent_id' => $post->getPostParentId(), 'visible' => $post->getVisible(), 'indent_cnt' => $depth, 'user_id' => $user->getUserId(), 'username' => $user->getUsername(), 'username_canonical' => $user->getUsernameCanonical(), 'lastname' => $user->getLastname(), 'firstname' => $user->getFirstname(), ]; if (!$recursive) { continue; } $list = array_merge( $list, getPosts( $threadId, $orderDirection, $recursive, $post->getPostId(), $depth ) ); } return $list; } /** * This function retrieves all the information of a post * * @param int $forum_id integer that indicates the forum * @return array returns * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function get_post_information($post_id) { $table_posts = Database :: get_course_table(TABLE_FORUM_POST); $table_users = Database :: get_main_table(TABLE_MAIN_USER); $course_id = api_get_course_int_id(); $sql = "SELECT * FROM ".$table_posts." posts, ".$table_users." users WHERE c_id = $course_id AND posts.poster_id=users.user_id AND posts.post_id = ".intval($post_id).""; $result = Database::query($sql); $row = Database::fetch_array($result); return $row; } /** * This function retrieves all the information of a thread * * @param $forum_id integer that indicates the forum * @return array returns * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function get_thread_information($thread_id) { $table_item_property = Database :: get_course_table(TABLE_ITEM_PROPERTY); $table_threads = Database :: get_course_table(TABLE_FORUM_THREAD); $course_id = api_get_course_int_id(); $thread_id = intval($thread_id); $sql = "SELECT * FROM ".$table_threads." threads, ".$table_item_property." item_properties WHERE item_properties.tool= '".TOOL_FORUM_THREAD."' AND item_properties.c_id = $course_id AND item_properties.ref = ".$thread_id." AND threads.thread_id = ".$thread_id." AND threads.c_id = $course_id "; $result = Database::query($sql); $row = Database::fetch_array($result); return $row; } /** * This function retrieves forum thread users details * @param int Thread ID * @param string Course DB name (optional) * @return resource array Array of type ([user_id=>w,lastname=>x,firstname=>y,thread_id=>z],[]) * @author Christian Fasanando , * @todo this function need to be improved * @version octubre 2008, dokeos 1.8 */ function get_thread_users_details($thread_id) { $t_posts = Database :: get_course_table(TABLE_FORUM_POST); $t_users = Database :: get_main_table(TABLE_MAIN_USER); $t_course_user = Database :: get_main_table(TABLE_MAIN_COURSE_USER); $t_session_rel_user = Database :: get_main_table(TABLE_MAIN_SESSION_COURSE_USER); $course_code = api_get_course_id(); $course_code = Database::escape_string($course_code); $course_id = api_get_course_int_id(); $is_western_name_order = api_is_western_name_order(); if ($is_western_name_order) { $orderby = 'ORDER BY user.firstname, user.lastname '; } else { $orderby = 'ORDER BY user.lastname, user.firstname'; } if (api_get_session_id()) { $session_info = api_get_session_info(api_get_session_id()); $user_to_avoid = "'".$session_info['id_coach']."', '".$session_info['session_admin_id']."'"; //not showing coaches $sql = "SELECT DISTINCT user.id, user.lastname, user.firstname, thread_id FROM $t_posts p, $t_users user, $t_session_rel_user session_rel_user_rel_course WHERE p.poster_id = user.id AND user.id = session_rel_user_rel_course.user_id AND session_rel_user_rel_course.status<>'2' AND session_rel_user_rel_course.user_id NOT IN ($user_to_avoid) AND p.thread_id = ".intval($thread_id)." AND session_id = ".api_get_session_id()." AND p.c_id = $course_id AND session_rel_user_rel_course.c_id = ".$course_id." $orderby "; } else { $sql = "SELECT DISTINCT user.id, user.lastname, user.firstname, thread_id FROM $t_posts p, $t_users user, $t_course_user course_user WHERE p.poster_id = user.id AND user.id = course_user.user_id AND course_user.relation_type<>".COURSE_RELATION_TYPE_RRHH." AND p.thread_id = ".intval($thread_id)." AND course_user.status NOT IN('1') AND p.c_id = $course_id AND course_user.c_id = ".$course_id." $orderby"; } $result = Database::query($sql); return $result; } /** * This function retrieves forum thread users qualify * @param int Thread ID * @param string Course DB name (optional) * @return array Array of type ([user_id=>w,lastname=>x,firstname=>y,thread_id=>z],[]) * @author Jhon Hinojosa * @todo this function need to be improved */ function get_thread_users_qualify($thread_id) { $t_posts = Database :: get_course_table(TABLE_FORUM_POST); $t_qualify = Database :: get_course_table(TABLE_FORUM_THREAD_QUALIFY); $t_users = Database :: get_main_table(TABLE_MAIN_USER); $t_course_user = Database :: get_main_table(TABLE_MAIN_COURSE_USER); $t_session_rel_user = Database :: get_main_table(TABLE_MAIN_SESSION_COURSE_USER); $course_id = api_get_course_int_id(); $is_western_name_order = api_is_western_name_order(); if ($is_western_name_order) { $orderby = 'ORDER BY user.firstname, user.lastname '; } else { $orderby = 'ORDER BY user.lastname, user.firstname'; } if (api_get_session_id()) { $session_info = api_get_session_info(api_get_session_id()); $user_to_avoid = "'".$session_info['id_coach']."', '".$session_info['session_admin_id']."'"; //not showing coaches $sql = "SELECT DISTINCT post.poster_id, user.lastname, user.firstname, post.thread_id,user.id,qualify.qualify FROM $t_posts post , $t_users user, $t_session_rel_user scu, $t_qualify qualify WHERE poster_id = user.id AND post.poster_id = qualify.user_id AND user.id = session_rel_user_rel_course.user_id AND scu.status<>'2' AND scu.user_id NOT IN ($user_to_avoid) AND qualify.thread_id = ".intval($thread_id)." AND post.thread_id = ".intval($thread_id)." AND session_id = ".api_get_session_id()." AND scu.c_id = ".$course_id." AND qualify.c_id = $course_id AND post.c_id = $course_id $orderby "; } else { $sql = "SELECT DISTINCT post.poster_id, user.lastname, user.firstname, post.thread_id,user.id,qualify.qualify FROM $t_posts post, $t_qualify qualify, $t_users user, $t_course_user course_user WHERE post.poster_id = user.id AND post.poster_id = qualify.user_id AND user.id = course_user.user_id AND course_user.relation_type<>".COURSE_RELATION_TYPE_RRHH." AND qualify.thread_id = ".intval($thread_id)." AND post.thread_id = ".intval($thread_id)." AND course_user.status not in('1') AND course_user.c_id = $course_id AND qualify.c_id = $course_id AND post.c_id = $course_id $orderby "; } $result = Database::query($sql); return $result; } /** * This function retrieves forum thread users not qualify * @param int Thread ID * @param string Course DB name (optional) * @return array Array of type ([user_id=>w,lastname=>x,firstname=>y,thread_id=>z],[]) * @author Jhon Hinojosa, * @version oct 2008, dokeos 1.8 */ function get_thread_users_not_qualify($thread_id) { $t_posts = Database :: get_course_table(TABLE_FORUM_POST); $t_qualify = Database :: get_course_table(TABLE_FORUM_THREAD_QUALIFY); $t_users = Database :: get_main_table(TABLE_MAIN_USER); $t_course_user = Database :: get_main_table(TABLE_MAIN_COURSE_USER); $t_session_rel_user = Database :: get_main_table(TABLE_MAIN_SESSION_COURSE_USER); $is_western_name_order = api_is_western_name_order(); if ($is_western_name_order) { $orderby = 'ORDER BY user.firstname, user.lastname '; } else { $orderby = 'ORDER BY user.lastname, user.firstname'; } $course_id = api_get_course_int_id(); $sql1 = "SELECT user_id FROM $t_qualify WHERE c_id = $course_id AND thread_id = '".$thread_id."'"; $result1 = Database::query($sql1); $cad = ''; while ($row = Database::fetch_array($result1)) { $cad .= $row['user_id'].','; } if ($cad == '') { $cad = '0'; } else { $cad = substr($cad, 0, strlen($cad) - 1); } if (api_get_session_id()) { $session_info = api_get_session_info(api_get_session_id()); $user_to_avoid = "'".$session_info['id_coach']."', '".$session_info['session_admin_id']."'"; //not showing coaches $sql = "SELECT DISTINCT user.id, user.lastname, user.firstname, post.thread_id FROM $t_posts post , $t_users user, $t_session_rel_user session_rel_user_rel_course WHERE poster_id = user.id AND user.id NOT IN (".$cad.") AND user.id = session_rel_user_rel_course.user_id AND session_rel_user_rel_course.status<>'2' AND session_rel_user_rel_course.user_id NOT IN ($user_to_avoid) AND post.thread_id = ".intval($thread_id)." AND session_id = ".api_get_session_id()." AND session_rel_user_rel_course.c_id = $course_id AND post.c_id = $course_id $orderby "; } else { $sql = "SELECT DISTINCT user.id, user.lastname, user.firstname, post.thread_id FROM $t_posts post, $t_users user,$t_course_user course_user WHERE post.poster_id = user.id AND user.id NOT IN (".$cad.") AND user.id = course_user.user_id AND course_user.relation_type<>".COURSE_RELATION_TYPE_RRHH." AND post.thread_id = ".intval($thread_id)." AND course_user.status not in('1') AND course_user.c_id = $course_id AND post.c_id = $course_id $orderby"; } $result = Database::query($sql); return $result; } /** * This function retrieves all the information of a given forum_id * * @param $forum_id integer that indicates the forum * @return array returns * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 * * @deprecated this functionality is now moved to get_forums($forum_id) */ function get_forum_information($forum_id, $courseId = 0) { $table_forums = Database :: get_course_table(TABLE_FORUM); $table_item_property = Database :: get_course_table(TABLE_ITEM_PROPERTY); $courseId = empty($courseId) ? api_get_course_int_id(): intval($courseId); $forum_id = intval($forum_id); $sql = "SELECT * FROM $table_forums forums INNER JOIN $table_item_property item_properties ON (forums.c_id = item_properties.c_id) WHERE item_properties.tool = '".TOOL_FORUM."' AND item_properties.ref = '".$forum_id."' AND forums.forum_id = '".$forum_id."' AND forums.c_id = ".$courseId." "; $result = Database::query($sql); $row = Database::fetch_array($result); $row['approval_direct_post'] = 0; // We can't anymore change this option, so it should always be activated. return $row; } /** * This function retrieves all the information of a given forumcategory id * * @param $forum_id integer that indicates the forum * @return array returns if there are category or bool returns if there aren't category * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function get_forumcategory_information($cat_id) { $table_categories = Database :: get_course_table(TABLE_FORUM_CATEGORY); $table_item_property = Database :: get_course_table(TABLE_ITEM_PROPERTY); $course_id = api_get_course_int_id(); $sql = "SELECT * FROM ".$table_categories." forumcategories, ".$table_item_property." item_properties WHERE forumcategories.c_id = $course_id AND item_properties.c_id = $course_id AND item_properties.tool='".TOOL_FORUM_CATEGORY."' AND item_properties.ref='".Database::escape_string($cat_id)."' AND forumcategories.cat_id='".Database::escape_string($cat_id)."'"; $result = Database::query($sql); $row = Database::fetch_array($result); return $row; } /** * This function counts the number of forums inside a given category * * @param $cat_id the id of the forum category * @todo an additional parameter that takes the visibility into account. For instance $countinvisible=0 would return the number * of visible forums, $countinvisible=1 would return the number of visible and invisible forums * @return int the number of forums inside the given category * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function count_number_of_forums_in_category($cat_id) { $table_forums = Database :: get_course_table(TABLE_FORUM); $course_id = api_get_course_int_id(); $sql = "SELECT count(*) AS number_of_forums FROM ".$table_forums." WHERE c_id = $course_id AND forum_category='".Database::escape_string($cat_id)."'"; $result = Database::query($sql); $row = Database::fetch_array($result); return $row['number_of_forums']; } /** * This function stores a new thread. This is done through an entry in the forum_thread table AND * in the forum_post table because. The threads are also stored in the item_property table. (forum posts are not (yet)) * * @param array $current_forum * @param array $values * @param array $courseInfo * @param bool $showMessage * @return void HTML * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function store_thread($current_forum, $values, $courseInfo = array(), $showMessage = true) { $courseInfo = empty($courseInfo) ? api_get_course_info() : $courseInfo ; $_user = api_get_user_info(); $course_id = $courseInfo['real_id']; $courseCode = $courseInfo['code']; $table_threads = Database :: get_course_table(TABLE_FORUM_THREAD); $table_posts = Database :: get_course_table(TABLE_FORUM_POST); $gradebook = isset($_GET['gradebook']) ? Security::remove_XSS($_GET['gradebook']) : ''; $upload_ok = 1; $has_attachment = false; if (!empty($_FILES['user_upload']['name'])) { $upload_ok = process_uploaded_file($_FILES['user_upload']); $has_attachment = true; } if ($upload_ok) { $post_date = api_get_utc_datetime(); if ($current_forum['approval_direct_post'] == '1' && !api_is_allowed_to_edit(null, true)) { $visible = 0; // The post has not been approved yet. } else { $visible = 1; } $clean_post_title = $values['post_title']; // We first store an entry in the forum_thread table because the thread_id is used in the forum_post table. $last_thread_id = Database::insert( $table_threads, [ 'c_id' => $course_id, 'thread_title' => $clean_post_title, 'forum_id' => $values['forum_id'], 'thread_poster_id' => $_user['user_id'], 'thread_poster_name' => stripslashes(isset($values['poster_name']) ? $values['poster_name'] : null), 'thread_date' => $post_date, 'thread_sticky' => isset($values['thread_sticky']) ? $values['thread_sticky'] : null, 'thread_title_qualify' => stripslashes($values['calification_notebook_title']), 'thread_qualify_max' => $values['numeric_calification'], 'thread_weight' => $values['weight_calification'], 'thread_peer_qualify' => $values['thread_peer_qualify'], 'session_id' => api_get_session_id() ] ); // Add option gradebook qualify. if (isset($values['thread_qualify_gradebook']) && 1 == $values['thread_qualify_gradebook'] ) { // Add function gradebook. $resourcetype = 5; $resourceid = $last_thread_id; $resourcename = stripslashes($values['calification_notebook_title']); $maxqualify = $values['numeric_calification']; $weigthqualify = $values['weight_calification']; $resourcedescription = ''; GradebookUtils::add_resource_to_course_gradebook( $values['category_id'], $courseCode, $resourcetype, $resourceid, $resourcename, $weigthqualify, $maxqualify, $resourcedescription, 0, api_get_session_id() ); } if ($last_thread_id) { $sql = "UPDATE $table_threads SET thread_id = $last_thread_id WHERE iid = $last_thread_id"; Database::query($sql); api_item_property_update( $courseInfo, TOOL_FORUM_THREAD, $last_thread_id, 'ForumThreadAdded', api_get_user_id(), api_get_group_id(), null, null, null, api_get_session_id() ); // If the forum properties tell that the posts have to be approved // we have to put the whole thread invisible, // because otherwise the students will see the thread and not the post // in the thread. // We also have to change $visible because the post itself has to be // visible in this case (otherwise the teacher would have // to make the thread visible AND the post. // Default behaviour api_set_default_visibility( $last_thread_id, TOOL_FORUM_THREAD, api_get_group_id(), $courseInfo ); if ($visible == 0) { api_item_property_update( $courseInfo, TOOL_FORUM_THREAD, $last_thread_id, 'invisible', api_get_user_id(), api_get_group_id() ); $visible = 1; } } // We now store the content in the table_post table. $params = [ 'c_id' => $course_id, 'post_title' => $clean_post_title, 'post_text' => $values['post_text'], 'thread_id' => $last_thread_id, 'forum_id' => $values['forum_id'], 'poster_id' => $_user['user_id'], 'poster_name' => isset($values['poster_name']) ? $values['poster_name'] : null, 'post_date' => $post_date, 'post_notification' => isset($values['post_notification']) ? $values['post_notification'] : null, 'post_parent_id' => 0, 'visible' => $visible, ]; $last_post_id = Database::insert($table_posts, $params); if ($last_post_id) { $sql = "UPDATE $table_posts SET post_id = $last_post_id WHERE iid = $last_post_id"; Database::query($sql); } // Update attached files if (!empty($_POST['file_ids']) && is_array($_POST['file_ids'])) { foreach ($_POST['file_ids'] as $key => $id) { editAttachedFile( array( 'comment' => $_POST['file_comments'][$key], 'post_id' => $last_post_id, ), $id ); } } // Now we have to update the thread table to fill the thread_last_post // field (so that we know when the thread has been updated for the last time). $sql = "UPDATE $table_threads SET thread_last_post = '".Database::escape_string($last_post_id)."' WHERE c_id = $course_id AND thread_id='".Database::escape_string($last_thread_id)."'"; $result = Database::query($sql); $message = get_lang('NewThreadStored'); // Storing the attachments if any. if ($has_attachment) { // Try to add an extension to the file if it hasn't one. $new_file_name = add_ext_on_mime( stripslashes($_FILES['user_upload']['name']), $_FILES['user_upload']['type'] ); if (!filter_extension($new_file_name)) { if ($showMessage) { Display:: display_error_message( get_lang('UplUnableToSaveFileFilteredExtension') ); } } else { if ($result) { add_forum_attachment_file( isset($values['file_comment']) ? $values['file_comment'] : null, $last_post_id ); } } } else { $message .= '
'; } if ($current_forum['approval_direct_post'] == '1' && !api_is_allowed_to_edit(null, true)) { $message .= get_lang('MessageHasToBeApproved').'
'; $message .= get_lang('ReturnTo').' '.get_lang('Forum').'
'; } else { $message .= get_lang('ReturnTo').' '.get_lang('Forum').'
'; $message .= get_lang('ReturnTo').' '.get_lang('Message').''; } $reply_info['new_post_id'] = $last_post_id; $my_post_notification = isset($values['post_notification']) ? $values['post_notification'] : null; if ($my_post_notification == 1) { set_notification('thread', $last_thread_id, true); } send_notification_mails($last_thread_id, $reply_info); Session::erase('formelements'); Session::erase('origin'); Session::erase('breadcrumbs'); Session::erase('addedresource'); Session::erase('addedresourceid'); if ($showMessage) { Display:: display_confirmation_message($message, false); } } else { if ($showMessage) { Display::display_error_message(get_lang('UplNoFileUploaded')); } } } /** * This function displays the form that is used to add a post. This can be a new thread or a reply. * @param array $current_forum * @param array $forum_setting * @param string $action is the parameter that determines if we are * 1. newthread: adding a new thread (both empty) => No I-frame * 2. replythread: Replying to a thread ($action = replythread) => I-frame with the complete thread (if enabled) * 3. replymessage: Replying to a message ($action =replymessage) => I-frame with the complete thread (if enabled) (I first thought to put and I-frame with the message only) * 4. quote: Quoting a message ($action= quotemessage) => I-frame with the complete thread (if enabled). The message will be in the reply. (I first thought not to put an I-frame here) * @return void HMTL * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function show_add_post_form($current_forum, $forum_setting, $action = '', $id = '', $form_values = '') { $_user = api_get_user_info(); $action = isset($_GET['action']) ? Security::remove_XSS($_GET['action']) : null; // Initialize the object. $myThread = isset($_GET['thread']) ? $_GET['thread'] : ''; $my_forum = isset($_GET['forum']) ? $_GET['forum'] : ''; $my_post = isset($_GET['post']) ? $_GET['post'] : ''; $my_gradebook = isset($_GET['gradebook']) ? Security::remove_XSS($_GET['gradebook']) : ''; $form = new FormValidator( 'thread', 'post', api_get_self().'?forum='.Security::remove_XSS($my_forum).'&'.api_get_cidreq().'&thread='.Security::remove_XSS($myThread).'&post='.Security::remove_XSS($my_post).'&action='.$action ); $form->setConstants(array('forum' => '5')); // Setting the form elements. $form->addElement('hidden', 'forum_id', intval($my_forum)); $form->addElement('hidden', 'thread_id', intval($myThread)); $form->addElement('hidden', 'gradebook', $my_gradebook); // If anonymous posts are allowed we also display a form to allow the user to put his name or username in. if ($current_forum['allow_anonymous'] == 1 && !isset($_user['user_id'])) { $form->addElement('text', 'poster_name', get_lang('Name')); $form->applyFilter('poster_name', 'html_filter'); } $form->addElement('text', 'post_title', get_lang('Title')); $form->addHtmlEditor( 'post_text', get_lang('Text'), true, api_is_allowed_to_edit(null, true) ? array( 'ToolbarSet' => 'Forum', 'Width' => '100%', 'Height' => '300', ) : array( 'ToolbarSet' => 'ForumStudent', 'Width' => '100%', 'Height' => '300', 'UserStatus' => 'student', ) ); $form->addRule('post_text', get_lang('ThisFieldIsRequired'), 'required'); $iframe = null; $myThread = Security::remove_XSS($myThread); if ($forum_setting['show_thread_iframe_on_reply'] && $action != 'newthread' && !empty($myThread)) { $iframe = ""; } if (!empty($iframe)) { $form->addElement('label', get_lang('Thread'), $iframe); } $form->addElement('advanced_settings', 'advanced_params', get_lang('AdvancedParameters')); $form->addElement('html', ''); if (in_array($action, ['quote', 'replymessage'])) { $form->addFile('user_upload[]', get_lang('Attachment')); $form->addButton( 'add_attachment', get_lang('AddAttachment'), 'paperclip', 'default', 'default', null, ['id' => 'reply-add-attachment'] ); } else { $form->addFile('user_upload', get_lang('Attachment')); } // Setting the class and text of the form title and submit button. if ($action == 'quote') { $form->addButtonCreate(get_lang('QuoteMessage'), 'SubmitPost'); } elseif ($action == 'replythread') { $form->addButtonCreate(get_lang('ReplyToThread'), 'SubmitPost'); } elseif ($action == 'replymessage') { $form->addButtonCreate(get_lang('ReplyToMessage'), 'SubmitPost'); } else { $form->addButtonCreate(get_lang('CreateThread'), 'SubmitPost'); } if (!empty($form_values)) { $defaults['post_title'] = prepare4display($form_values['post_title']); $defaults['post_text'] = prepare4display($form_values['post_text']); $defaults['post_notification'] = strval(intval($form_values['post_notification'])); $defaults['thread_sticky'] = strval(intval($form_values['thread_sticky'])); $defaults['thread_peer_qualify'] = intval($form_values['thread_peer_qualify']); } else { $defaults['thread_peer_qualify'] = 0; } // If we are quoting a message we have to retrieve the information of the post we are quoting so that // we can add this as default to the textarea. if (($action == 'quote' || $action == 'replymessage') && isset($my_post)) { // We also need to put the parent_id of the post in a hidden form when we are quoting or replying to a message (<> reply to a thread !!!) $form->addElement('hidden', 'post_parent_id', intval($my_post)); // If we are replying or are quoting then we display a default title. $values = get_post_information($my_post); $defaults['post_title'] = get_lang('ReplyShort').api_html_entity_decode($values['post_title'], ENT_QUOTES); // When we are quoting a message then we have to put that message into the wysiwyg editor. // Note: The style has to be hardcoded here because using class="quote" didn't work. if ($action == 'quote') { $defaults['post_text'] = '
 
'.get_lang('Quoting').' '.api_get_person_name($values['firstname'], $values['lastname']).':
'.prepare4display($values['post_text']).'
 
 
'; } } $form->setDefaults(isset($defaults) ? $defaults : null); // The course admin can make a thread sticky (=appears with special icon and always on top). $form->addRule('post_title', get_lang('ThisFieldIsRequired'), 'required'); if ($current_forum['allow_anonymous'] == 1 && !isset($_user['user_id'])) { $form->addRule('poster_name', get_lang('ThisFieldIsRequired'), 'required'); } // Validation or display if ($form->validate()) { $check = Security::check_token('post'); if ($check) { $values = $form->exportValues(); if (isset($values['thread_qualify_gradebook']) && $values['thread_qualify_gradebook'] == '1' && empty($values['weight_calification']) ) { Display::display_error_message( get_lang('YouMustAssignWeightOfQualification').' '.get_lang('Back').'', false ); return false; } Security::clear_token(); return $values; } } else { $token = Security::get_token(); $form->addElement('hidden', 'sec_token'); $form->setConstants(array('sec_token' => $token)); // Delete from $_SESSION forum attachment from other posts // and keep only attachments for new post clearAttachedFiles(FORUM_NEW_POST); // Get forum attachment ajax table to add it to form $attachmentAjaxTable = getAttachmentsAjaxTable(0, $current_forum['forum_id']); $ajaxHtml = $attachmentAjaxTable; $form->addElement('html', $ajaxHtml); $form->display(); } } /** * @param array $threadInfo * @param integer $user_id * @param integer $thread_id * @param integer $thread_qualify * @param integer $qualify_time * @param integer $session_id * @return Array() optional * @author Isaac Flores , U.N.A.S University * @version October 2008, dokeos 1.8.6 */ function saveThreadScore( $threadInfo, $user_id, $thread_id, $thread_qualify = 0, $qualify_time, $session_id = 0 ) { $table_threads_qualify = Database::get_course_table(TABLE_FORUM_THREAD_QUALIFY); $table_threads = Database::get_course_table(TABLE_FORUM_THREAD); $course_id = api_get_course_int_id(); $session_id = intval($session_id); $currentUserId = api_get_user_id(); if ($user_id == strval(intval($user_id)) && $thread_id == strval(intval($thread_id)) && $thread_qualify == strval(floatval($thread_qualify)) ) { // Testing $sql = "SELECT thread_qualify_max FROM $table_threads WHERE c_id = $course_id AND thread_id=".$thread_id; $res_string = Database::query($sql); $row_string = Database::fetch_array($res_string); if ($thread_qualify <= $row_string[0]) { if ($threadInfo['thread_peer_qualify'] == 0) { $sql = "SELECT COUNT(*) FROM $table_threads_qualify WHERE c_id = $course_id AND user_id = $user_id AND thread_id = ".$thread_id; } else { $sql = "SELECT COUNT(*) FROM $table_threads_qualify WHERE c_id = $course_id AND user_id = $user_id AND qualify_user_id = $currentUserId AND thread_id = ".$thread_id; } $result = Database::query($sql); $row = Database::fetch_array($result); if ($row[0] == 0) { $sql = "INSERT INTO $table_threads_qualify (c_id, user_id, thread_id,qualify,qualify_user_id,qualify_time,session_id) VALUES (".$course_id.", '".$user_id."','".$thread_id."',".(float)$thread_qualify.", '".$currentUserId."','".$qualify_time."','".$session_id."')"; Database::query($sql); $insertId = Database::insert_id(); if ($insertId) { $sql = "UPDATE $table_threads_qualify SET id = iid WHERE iid = $insertId"; Database::query($sql); } return 'insert'; } else { saveThreadScoreHistory( '1', $course_id, $user_id, $thread_id ); // Update $sql = "UPDATE $table_threads_qualify SET qualify = '".$thread_qualify."', qualify_time = '".$qualify_time."' WHERE c_id = $course_id AND user_id=".$user_id." AND thread_id=".$thread_id." AND qualify_user_id = $currentUserId "; Database::query($sql); return 'update'; } } else { return null; } } } /** * This function shows qualify. * @param string $option contains the information of option to run * @param integer $user_id contains the information the current user id * @param integer $thread_id contains the information the current thread id * @return integer qualify * $option=1 obtained the qualification of the current thread * @author Isaac Flores , U.N.A.S University * @version October 2008, dokeos 1.8.6 */ function showQualify($option, $user_id, $thread_id) { $table_threads_qualify = Database::get_course_table(TABLE_FORUM_THREAD_QUALIFY); $table_threads = Database::get_course_table(TABLE_FORUM_THREAD); $course_id = api_get_course_int_id(); $user_id = intval($user_id); $thread_id = intval($thread_id); if (empty($user_id) || empty($thread_id)) { return false; } $sql = ''; switch ($option) { case 1: $sql = "SELECT qualify FROM $table_threads_qualify WHERE c_id = $course_id AND user_id=".$user_id." AND thread_id=".$thread_id; break; case 2: $sql = "SELECT thread_qualify_max FROM $table_threads WHERE c_id = $course_id AND thread_id=".$thread_id; break; } if (!empty($sql)) { $rs = Database::query($sql); $row = Database::fetch_array($rs); return $row[0]; } return array(); } /** * This function gets qualify historical. * @param integer $user_id contains the information the current user id * @param integer $thread_id contains the information the current thread id * @param boolean $opt contains the information of option to run * @return array() * @author Christian Fasanando , * @author Isaac Flores , * @version October 2008, dokeos 1.8.6 */ function getThreadScoreHistory($user_id, $thread_id, $opt) { $table_threads_qualify_log = Database::get_course_table(TABLE_FORUM_THREAD_QUALIFY_LOG); $course_id = api_get_course_int_id(); if ($opt == 'false') { $sql = "SELECT * FROM ".$table_threads_qualify_log." WHERE c_id = $course_id AND thread_id='".Database::escape_string($thread_id)."' AND user_id='".Database::escape_string($user_id)."' ORDER BY qualify_time"; } else { $sql = "SELECT * FROM ".$table_threads_qualify_log." WHERE c_id = $course_id AND thread_id='".Database::escape_string($thread_id)."' AND user_id='".Database::escape_string($user_id)."' ORDER BY qualify_time DESC"; } $rs = Database::query($sql); $log = array(); while ($row = Database::fetch_array($rs, 'ASSOC')) { $log[] = $row; } return $log; } /** * This function stores qualify historical. * @param boolean contains the information of option to run * @param string contains the information the current course id * @param integer contains the information the current forum id * @param integer contains the information the current user id * @param integer contains the information the current thread id * @param integer contains the information the current qualify * @return void * $option=1 obtained the qualification of the current thread * @author Isaac Flores , U.N.A.S University * @version October 2008, dokeos 1.8.6 */ function saveThreadScoreHistory( $option, $course_id, $user_id, $thread_id ) { $table_threads_qualify = Database::get_course_table(TABLE_FORUM_THREAD_QUALIFY); $table_threads_qualify_log = Database::get_course_table(TABLE_FORUM_THREAD_QUALIFY_LOG); $course_id = intval($course_id); $qualify_user_id = api_get_user_id(); if ($user_id == strval(intval($user_id)) && $thread_id == strval(intval($thread_id)) && $option == 1 ) { // Extract information of thread_qualify. $sql = "SELECT qualify, qualify_time FROM $table_threads_qualify WHERE c_id = $course_id AND user_id = ".$user_id." AND thread_id = ".$thread_id." AND qualify_user_id = $qualify_user_id "; $rs = Database::query($sql); $row = Database::fetch_array($rs); // Insert thread_historical. $sql = "INSERT INTO $table_threads_qualify_log (c_id, user_id, thread_id, qualify, qualify_user_id,qualify_time,session_id) VALUES(".$course_id.", '".$user_id."','".$thread_id."',".(float) $row[0].", '".$qualify_user_id."','".$row[1]."','')"; Database::query($sql); $insertId = Database::insert_id(); if ($insertId) { $sql = "UPDATE $table_threads_qualify_log SET id = iid WHERE iid = $insertId"; Database::query($sql); } } } /** * This function shows current thread qualify . * @param integer $threadId * @param integer $sessionId * @param integer $userId * * @return array or null if is empty * @author Isaac Flores , U.N.A.S University * @version December 2008, dokeos 1.8.6 */ function current_qualify_of_thread($threadId, $sessionId, $userId) { $table_threads_qualify = Database::get_course_table(TABLE_FORUM_THREAD_QUALIFY); $course_id = api_get_course_int_id(); $currentUserId = api_get_user_id(); $sessionId = intval($sessionId); $threadId = intval($threadId); $sql = "SELECT qualify FROM $table_threads_qualify WHERE c_id = $course_id AND thread_id = $threadId AND session_id = $sessionId AND qualify_user_id = $currentUserId AND user_id = $userId "; $res = Database::query($sql); $row = Database::fetch_array($res, 'ASSOC'); return $row['qualify']; } /** * This function stores a reply in the forum_post table. * It also updates the forum_threads table (thread_replies +1 , thread_last_post, thread_date) * @param array $current_forum * @param array $values * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function store_reply($current_forum, $values) { $_course = api_get_course_info(); $table_posts = Database :: get_course_table(TABLE_FORUM_POST); $post_date = api_get_utc_datetime(); if ($current_forum['approval_direct_post'] == '1' && !api_is_allowed_to_edit(null, true)) { $visible = 0; } else { $visible = 1; } $upload_ok = 1; $return = array(); if ($upload_ok) { // We first store an entry in the forum_post table. $new_post_id = Database::insert( $table_posts, [ 'c_id' => api_get_course_int_id(), 'post_title' => $values['post_title'], 'post_text' => isset($values['post_text']) ? ($values['post_text']) : null, 'thread_id' => $values['thread_id'], 'forum_id' => $values['forum_id'], 'poster_id' => api_get_user_id(), 'post_date' => $post_date, 'post_notification' => isset($values['post_notification']) ? $values['post_notification'] : null, 'post_parent_id' => isset($values['post_parent_id']) ? $values['post_parent_id'] : null, 'visible' => $visible ] ); if ($new_post_id) { $sql = "UPDATE $table_posts SET post_id = iid WHERE iid = $new_post_id"; Database::query($sql); $values['new_post_id'] = $new_post_id; $message = get_lang('ReplyAdded'); if (!empty($_POST['file_ids']) && is_array($_POST['file_ids'])) { foreach ($_POST['file_ids'] as $key => $id) { editAttachedFile( array( 'comment' => $_POST['file_comments'][$key], 'post_id' => $new_post_id ), $id ); } } // Update the thread. update_thread($values['thread_id'], $new_post_id, $post_date); // Update the forum. api_item_property_update( $_course, TOOL_FORUM, $values['forum_id'], 'NewMessageInForum', api_get_user_id() ); if ($current_forum['approval_direct_post'] == '1' && !api_is_allowed_to_edit( null, true ) ) { $message .= '
'.get_lang( 'MessageHasToBeApproved' ).'
'; } // Setting the notification correctly. $my_post_notification = isset($values['post_notification']) ? $values['post_notification'] : null; if ($my_post_notification == 1) { set_notification('thread', $values['thread_id'], true); } send_notification_mails($values['thread_id'], $values); add_forum_attachment_file('', $new_post_id); } Session::erase('formelements'); Session::erase('origin'); Session::erase('breadcrumbs'); Session::erase('addedresource'); Session::erase('addedresourceid'); $return['msg'] = $message; $return['type'] = 'confirmation'; } else { $return['msg'] = get_lang('UplNoFileUploaded').' '.get_lang('UplSelectFileFirst'); $return['type'] = 'error'; } return $return; } /** * This function displays the form that is used to edit a post. This can be a new thread or a reply. * @param array contains all the information about the current post * @param array contains all the information about the current thread * @param array contains all info about the current forum (to check if attachments are allowed) * @param array contains the default values to fill the form * @return void * * @author Patrick Cool , Ghent University * @version february 2006, dokeos 1.8 */ function show_edit_post_form($forum_setting, $current_post, $current_thread, $current_forum, $form_values = '', $id_attach = 0) { // Initialize the object. $form = new FormValidator( 'edit_post', 'post', api_get_self().'?'.api_get_cidreq().'&forum='.Security::remove_XSS($_GET['forum']).'&thread='.Security::remove_XSS($_GET['thread']).'&post='.Security::remove_XSS($_GET['post']) ); $form->addElement('header', get_lang('EditPost')); // Setting the form elements. $form->addElement('hidden', 'post_id', $current_post['post_id']); $form->addElement('hidden', 'thread_id', $current_thread['thread_id']); $form->addElement('hidden', 'id_attach', $id_attach); if ($current_post['post_parent_id'] == 0) { $form->addElement('hidden', 'is_first_post_of_thread', '1'); } $form->addElement('text', 'post_title', get_lang('Title')); $form->applyFilter('post_title', 'html_filter'); $form->addElement( 'html_editor', 'post_text', get_lang('Text'), null, api_is_allowed_to_edit(null, true) ? array( 'ToolbarSet' => 'Forum', 'Width' => '100%', 'Height' => '400' ) : array( 'ToolbarSet' => 'ForumStudent', 'Width' => '100%', 'Height' => '400', 'UserStatus' => 'student' ) ); $form->addRule('post_text', get_lang('ThisFieldIsRequired'), 'required'); $form->addButtonAdvancedSettings('advanced_params'); $form->addElement('html', '