【授权】EduSoho二次开发文档

EduSoho二次开发文档文档版本：1.0最后更新：2014-3-25程序主要文件目录结构说明App/cache缓存目录App/config程序配置目录App/data程序私有文件上传目录App/logs程序日志Src/程序业务源代码目录Src/Topxia/WebBundle前台界面代码目录Src/Topxia/AdminBundle管理后台界面代码目录Src/Topxia/Service核心业务代码目录Src/Topxia/DataTag模板标签目录Src/Topxia/Common程序通用类目录Vendor程序依赖的第三方库Vendor_user程序依赖的第三方应用中心类库WebWebServer根目录Web/app.php程序主入口文件Web/bundles程序前后台资源文件Web/themes程序主题目录系统主要业务逻辑模块说明模块文件地址说明Src/Topxia/Service/Course/CourseService课程核心服务Src/Topxia/Service/Course/MaterialService课程资料服务Src/Topxia/Service/Course/NoteService课程笔记服务Src/Topxia/Service/Course/ReviewService课程评价Src/Topxia/Service/Course/ThreadService课程讨论区服务，含话题及问答Src/Topxia/Service/User/UserService用户服务Src/Topxia/Service/User/MessageService私信服务Src/Topxia/Service/User/NotificationService系统通知服务Src/Topxia/Service/Taxonomy/CategoryService分类服务Src/Topxia/Service/Taxonomy/TagService标签服务Src/Topxia/Service/System/LogService日志服务Src/Topxia/Service/System/SettingService系统设置服务Src/Topxia/Service/Testpaper/TestpaperService题库服务开启开发模式程序默认运行在生产环境(prod)下，如需做二次开发，请开启开发模式，步骤如下：1.打开web/app.php修改：$kernel=newAppKernel('prod',false);为：$kernel=newAppKernel(dev',true);开发Hello,World!做二次开发时，为保持系统能正常跟随EduSoho官方升级，尽量不要修改EduSoho核心代码，而是以扩展的方式来做二次开发。二次开发的代码，请保持在src/Custom目录下。第一步：添加路由打开src/Custom/WebBundle/Resources/config/routing.yml文件添加代码：hello_world:pattern:/hello/worlddefaults:{_controller:CustomWebBundle:Hello:world}第二步：创建控制器新建src/Custom/WebBundle/Controller/HelloController.php文件添加代码：?phpnamespaceCustom\WebBundle\Controller;useTopxia\WebBundle\Controller\BaseController;classHelloControllerextendsBaseController{publicfunctionworldAction(){return$this-render('CustomWebBundle:Hello:world.html.twig');}}第三步：创建模板代码新建src/Custom/WebBundle/Resources/views/Hello/world.html.twig文件输入以下内容：Hello,World!第四步：打开浏览器，检验结果打开浏览器，输入网址：，这个时候页面显示“Hello,World!”，恭喜，你成功了！框架开发文档EduSoho基于一系列的开源框架/类库搭建，EduSoho二次开发之前，还需学习以下开源框架及类库的使用。前端开发文档jQuery:Seajs:Arale:Bootstrap:后端开发文档Symfony2:Twig:模板标签说明模板标签，用于主题的定制。标签的使用，请参照：web/themes/autumn/TopxiaWebBundle/views/Default/index.html.twig。标签名称参数功能说明Course[必须]courseId:课程ID获取一个课程对象LatestCourses[可选]categoryId:分类ID[必须]count:课程数量，取值不能超过100获取最新课程列表PopularCourses[可选]categoryId:分类ID[必须]count:课程数量，取值不能超过100获取热门课程列表RecommendCourses[可选]categoryId:分类ID[必须]count:课程数量，取值不能超过100获取推荐课程列表RecommendCourses[可选]categoryId:分类ID[必须]count:课程数量，取值不能超过100获取推荐课程列表FreeCourses[可选]categoryId:分类ID[必须]count:课程数量，取值不能超过100获取免费课程列表TeacherCourses[必须]userId:老师ID[必须]count:课程数量，取值不能超过100获取一个老师的课程列表CourseRankByRating[必须]count:课程数量，取值不能超过100获取按评分排列的课程排行列表CourseRankByStudent[必须]count:课程数量，取值不能超过100获取按学员数排列的课程排行列表CourseRankByHit[必须]count:课程数量，取值不能超过100获取按点击数排列的课程排行列表UserLatestLearnCourses[必须]userId:用户ID[必须]count:课程数量，取值不能超过100获取一个用户最近学习的课程列表CourseLessons[必须]courseId:课程ID[必须]count:课程数量，取值不能超过100获取一个课程的课时列表CourseThread[必须]courseId:课程ID[必须]threadId:话题ID获取一个课程的一个话题对象LatestCourseThreads[必须]count:课程数量，取值不能超过100[必须]courseId:课程ID获取一个课程最新发表的话题列表ElitedCourseThreads[必须]count:课程数量，取值不能超过100[必须]courseId:课程ID获取一个课程的精选话题列表LatestCourseQuestions[必须]count:课程数量，取值不能超过100[必须]courseId:课程ID获取一个课程最新发表的问答列表ElitedCourseQuestions[必须]count:课程数量，取值不能超过100[必须]courseId:课程ID获取一个课程的精选问答列表CourseReview[必须]reviewId:评论ID获取一个课程评价对象LatestCourseReviews[必须]count:课程评论数量，取值不能超过100[可选]courseId:课程ID获取最新课程评论列表TopRatingCourseReviews[必须]count:课程评论数量，取值不能超过100[可选]courseId:课程ID获取好评评论列表Category[必须]categoryId:分类ID获取一个分类对象Categories[必须]group:'course'返回所有分类获取所有分类User[必须]UserId:用户ID获取一个用户对象LatestUsers[必须]count:用户数量，取值不能超过100获取最新用户列表LatestLoginUsers[必须]count:用户数量，取值不能超过100获取最近登录的用户列表LatestTeachers[必须]count:用户数量，取值不能超过100获取最新老师列表RecommendTeachers[必须]count:用户数量，取值不能超过100获取推荐老师列表